All endpoints
Reddit Post Crossposts

Reddit Post Crossposts API

Get the other submissions of a Reddit post's link across Reddit: crossposts and reposts of the same URL, by post URL or ID. Returns the same post fields as Post Details for each one (subreddit, author, date, score, upvote ratio, comment count). Up to 100 per request.

Price: $0.003 per request
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/reddit/post/crossposts

Parameters

url
Reddit post URL, e.g. https://www.reddit.com/r/Python/comments/1wwv97o/my_python_magic_is_gone/ or https://redd.it/1wwv97o (max 500 characters). Provide exactly one of url or post_id.
post_id
Reddit post ID, e.g. 1wwv97o (a t3_ prefix is accepted). Provide exactly one of url or post_id.
get_sentiment
Set to true to add AI emotion analysis (+$0.001/request)

Response fields

posts
Crossposts and reposts of the post's link
post_id
Post ID (the base-36 ID in the post URL)
title
Post title
url
Direct link to the post
date
Publication date and time (UTC)
author
Author's Reddit username ([deleted] for a deleted account)
author_url
Link to the author's profile (empty for a deleted account)
source
"Reddit"
domain
"reddit.com"
snippet
Post text (the title for link, image and video posts)
subreddit
Subreddit name
upvotes
Net upvotes (upvotes minus downvotes)
upvote_ratio
Fraction of votes that are upvotes, between 0 and 1
comments
Number of comments
crossposts
Number of times the post has been crossposted
flair
Post flair text, or empty string
link_url
The URL a link, image or video post shares (empty for text posts)
thumbnail
Thumbnail image URL, or empty string
is_video
Whether the post is a Reddit-hosted video
nsfw
Whether the post is marked NSFW
spoiler
Whether the post is marked as a spoiler
locked
Whether the post is locked to new comments
stickied
Whether the post is pinned in its subreddit
video_url
MP4 file of a Reddit-hosted video, or empty string. It can be silent (Reddit stores most video sound separately), so use video_hls_url for video with sound. Reddit can expire video links, so use them soon after fetching
video_hls_url
HLS stream (with sound) of a Reddit-hosted video, or empty string. Reddit can expire this link too
images
Image URLs: every image of a gallery post, in order, or the image of an image post (empty otherwise)
sentiment
Emotion analysis: emotions, dominant_emotion, emotional_intensity, polarity (when get_sentiment=true)
post_id
The original post's ID
count
Number of posts returned

Example Request

curl "https://apidirect.io/v1/reddit/post/crossposts?post_id=z1c9z" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "posts": [
    {
      "post_id": "x0hiil",
      "title": "President Obama does a Reddit AMA [10YA - Aug 29]",
      "url": "https://www.reddit.com/r/TenYearsAgo/comments/x0hiil/president_obama_does_a_reddit_ama_10ya_aug_29/",
      "date": "2022-08-29 06:25:55",
      "author": "MonsieurA",
      "author_url": "https://www.reddit.com/user/MonsieurA",
      "source": "Reddit",
      "domain": "reddit.com",
      "snippet": "President Obama does a Reddit AMA [10YA - Aug 29]",
      "subreddit": "TenYearsAgo",
      "upvotes": 27,
      "upvote_ratio": 0.91,
      "comments": 4,
      "crossposts": 0,
      "flair": "Technology & Internet",
      "link_url": "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/",
      "thumbnail": "",
      "is_video": false,
      "nsfw": false,
      "spoiler": false,
      "locked": false,
      "stickied": false,
      "video_url": "",
      "video_hls_url": "",
      "images": [],
      "sentiment": {
        "emotions": {
          "joy": 40,
          "trust": 55,
          "fear": 0,
          "surprise": 10,
          "sadness": 0,
          "disgust": 0,
          "anger": 0,
          "anticipation": 30
        },
        "dominant_emotion": "trust",
        "emotional_intensity": 5,
        "polarity": "positive"
      }
    }
  ],
  "post_id": "z1c9z",
  "count": 13
}

Frequently asked questions

What counts as a crosspost here?

Any other submission of the same link: crossposts made with Reddit's crosspost button and separate posts of the same URL.

Why is the list empty?

The post's link hasn't been submitted anywhere else, or the post is a text post nobody crossposted.

How does pricing work?

You only pay for successful requests. The Reddit Post Crossposts API costs $0.003 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the Reddit Post Crossposts API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key