Reddit Post API
The Reddit Post API returns one post from
Reddit
as structured JSON: its title, text, author, subreddit, score, comment count and media, who
removed it if it was removed, and its first top-level comments in the order Reddit shows them. Look a post up by its ID, such as the id of a
Reddit Search API result, or by its link, including
share links from the Reddit app. NSFW posts are returned only when safe is off.
API Parameters
Post
-
- Name
-
post_id - Required
- Optional
- Description
-
The ID of the post. Use the
idof a Reddit Search API result, for examplet3_ckbolc, or the ID in a post link, for exampleckbolc.
Required ifurlis not provided.
-
- Name
-
url - Required
- Optional
- Description
-
The link to the post, for example
https://www.reddit.com/r/aww/comments/ckbolc/this_is_tiger_he_just_turned_31_we_are_told_he_is/. Links fromold.reddit.comandredd.it, and share links from the Reddit app, work as well.
Required ifpost_idis not provided.
Filters
-
- Name
-
safe - Required
- Optional
- Description
-
Controls NSFW posts.
active(default) answers an NSFW post with an error,offreturns it.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
reddit_post.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Post
comments holds the first 10 top-level comments, in the order Reddit shows them under the post.
https://www.searchapi.org/api/v1/search?engine=reddit_post&post_id=t3_ckbolc
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "reddit_post",
"post_id": "t3_ckbolc"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_7L8KlJ0oGB6Tvd1Pg6Y1GkOE",
"status": "Success",
"created_at": "2026-10-28T16:54:18Z",
"request_time_taken": 3.59,
"parsing_time_taken": 0.04,
"total_time_taken": 3.63,
"request_url": "https://www.reddit.com/comments/ckbolc/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_7L8KlJ0oGB6Tvd1Pg6Y1GkOE.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_7L8KlJ0oGB6Tvd1Pg6Y1GkOE"
},
"search_parameters": {
"engine": "reddit_post",
"post_id": "t3_ckbolc"
},
"post": {
"id": "t3_ckbolc",
"title": "This is Tiger. He just turned 31. We are told he is the oldest cat in the state of Illinois",
"link": "https://www.reddit.com/r/aww/comments/ckbolc/this_is_tiger_he_just_turned_31_we_are_told_he_is/",
"type": "image",
"author": {
"username": "Aritilli",
"link": "https://www.reddit.com/user/Aritilli/"
},
"subreddit": {
"name": "aww",
"id": "t5_2qh1o",
"link": "https://www.reddit.com/r/aww/",
"icon": "https://styles.redditmedia.com/t5_2qh1o/styles/communityIcon_uz6ge49x9h6e1.png?width=64&frame=1&auto=webp&s=9ea737d382b5ba17319c3cc5f6b80474a13a488f"
},
"score": 200051,
"comments": 4586,
"image": "https://i.redd.it/sg3q5cuedod31.jpg",
"thumbnail": "https://preview.redd.it/this-is-tiger-he-just-turned-31-we-are-told-he-is-the-v0-sg3q5cuedod31.jpg?width=1080&crop=smart&auto=webp&s=6824975079a310727811230f53ae9c3649c9bc03",
"iso_date": "2019-07-31T17:36:04Z"
},
"comments": [
{
"position": 1,
"id": "t1_evlphxf",
"author": {
"username": "j1022",
"id": "t2_cv5xb",
"link": "https://www.reddit.com/user/j1022/"
},
"text": "So do you feed him anything special or do anything to help extend his life?",
"link": "https://www.reddit.com/r/aww/comments/ckbolc/comment/evlphxf/",
"score": 3091,
"iso_date": "2019-07-31T18:25:48Z"
},
"..."
]
}
Post by Link
https://www.searchapi.org/api/v1/search?engine=reddit_post&url=https%3A%2F%2Fwww.reddit.com%2Fr%2FIAmA%2Fcomments%2Fz1c9z%2Fi_am_barack_obama_president_of_the_united_states%2F
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "reddit_post",
"url": "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Qzy2PnvoBkZC7DAL3Yx0EK15",
"status": "Success",
"created_at": "2026-10-28T16:54:23Z",
"request_time_taken": 2.56,
"parsing_time_taken": 0.04,
"total_time_taken": 2.6,
"request_url": "https://www.reddit.com/comments/z1c9z/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Qzy2PnvoBkZC7DAL3Yx0EK15.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Qzy2PnvoBkZC7DAL3Yx0EK15"
},
"search_parameters": {
"engine": "reddit_post",
"url": "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/"
},
"post": {
"id": "t3_z1c9z",
"title": "I am Barack Obama, President of the United States -- AMA",
"link": "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/",
"type": "text",
"author": {
"username": "PresidentObama",
"link": "https://www.reddit.com/user/PresidentObama/"
},
"subreddit": {
"name": "IAmA",
"id": "t5_2qzb6",
"link": "https://www.reddit.com/r/IAmA/",
"icon": "https://styles.redditmedia.com/t5_2qzb6/styles/communityIcon_v0zs2b3d7f251.png?width=64&frame=1&auto=webp&s=28ec291f4c3f4776dfe5345f3a5c880493bf4535"
},
"score": 216186,
"comments": 22716,
"text": "Hi, I’m Barack Obama, President of the United States. Ask me anything. I’ll be taking your questions for half an hour starting at about 4:30 ET.\n\nProof it's me: https://twitter.com/BarackObama/status/240903767350968320\n\nWe're running early and will get started soon.\n\nUPDATE: Hey everybody - this is barack. Just finished a great rally in Charlottesville, and am looking forward to your questions. At the top, I do want to say that our thoughts and prayers are with folks who are dealing with Hurricane Isaac in the Gulf, and to let them know that we are going to be coordinating with state and local officials to make sure that we give families everything they need to recover.\n\nVerification photo: http://i.imgur.com/oz0a7.jpg\n\nLAST UPDATE: I need to get going so I'm back in DC in time for dinner. But I want to thank everybody at reddit for participating - this is an example of how technology and the internet can empower the sorts of conversations that strengthen our democracy over the long run. AND REMEMBER TO VOTE IN NOVEMBER - if you need to know how to register, go to http://gottaregister.com. By the way, if you want to know what I think about this whole reddit experience - NOT BAD!\n\nhttp://www.barackobama.com/reddit [edit: link fixed by staff]",
"text_links": [
"https://twitter.com/BarackObama/status/240903767350968320",
"..."
],
"iso_date": "2012-08-29T20:01:36Z",
"is_archived": true
},
"comments": [
{
"position": 1,
"id": "t1_c60mmaf",
"author": {
"username": "gobearss",
"id": "t2_60d4r",
"link": "https://www.reddit.com/user/gobearss/"
},
"text": "How do you balance family life and hobbies with, well, being the POTUS?",
"link": "https://www.reddit.com/r/IAmA/comments/z1c9z/comment/c60mmaf/",
"score": 1556,
"iso_date": "2012-08-29T20:05:19Z"
},
"..."
]
}
Gallery
images lists every image of a gallery in display order, with the caption the author gave it.
https://www.searchapi.org/api/v1/search?engine=reddit_post&post_id=t3_1p1iw69
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "reddit_post",
"post_id": "t3_1p1iw69"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_r07vRBGpw4dcaPvegb6ZlXJj",
"status": "Success",
"created_at": "2026-10-28T16:54:26Z",
"request_time_taken": 2.34,
"parsing_time_taken": 0.05,
"total_time_taken": 2.39,
"request_url": "https://www.reddit.com/comments/1p1iw69/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_r07vRBGpw4dcaPvegb6ZlXJj.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_r07vRBGpw4dcaPvegb6ZlXJj"
},
"search_parameters": {
"engine": "reddit_post",
"post_id": "t3_1p1iw69"
},
"post": {
"id": "t3_1p1iw69",
"title": "NASA's latest images of the interstellar comet 3I/ATLAS",
"link": "https://www.reddit.com/user/nasa/comments/1p1iw69/nasas_latest_images_of_the_interstellar_comet/",
"type": "gallery",
"author": {
"username": "nasa",
"link": "https://www.reddit.com/user/nasa/"
},
"subreddit": {
"name": "u_nasa",
"link": "https://www.reddit.com/user/nasa/",
"icon": "https://styles.redditmedia.com/t5_k5gc6/styles/profileIcon_ydyqarnwt7s91.png?width=64&height=64&frame=1&auto=webp&crop=64:64,smart&s=301061802a64d43cd3f39390123e129d22db705f"
},
"score": 461,
"comments": 74,
"thumbnail": "https://preview.redd.it/nasas-latest-images-of-the-interstellar-comet-3i-atlas-v0-8btwviggw92g1.png?width=830&format=png&auto=webp&s=9786afa7cf325813f308eda670876f8bcd568648",
"images": [
{
"link": "https://preview.redd.it/nasas-latest-images-of-the-interstellar-comet-3i-atlas-v0-8btwviggw92g1.png?width=830&format=png&auto=webp&s=9786afa7cf325813f308eda670876f8bcd568648",
"caption": "3I/ATLAS from NASA's Mars Reconnaissance Orbiter"
},
"..."
],
"iso_date": "2025-11-19T20:29:50Z"
},
"comments": [
{
"position": 1,
"id": "t1_npq8y2k",
"author": {
"username": "nasa",
"id": "t2_1dkvvygb",
"link": "https://www.reddit.com/user/nasa/"
},
"text": "Comet 3I/ATLAS is only the third object we've ever seen passing through our solar system from elsewhere in the galaxy. (And yes, every observation our spacecraft and telescopes have made is consistent with 3I/ATLAS being a comet.)\n\nInterstellar objects give us a unique opportunity to learn more about what solar systems beyond ours are made of, so astronomers have been keeping a close eye on comet 3I/ATLAS on its arc around our Sun. Today's release of images, collected over the last several weeks, includes observations from eight different spacecraft, satellites, and telescopes, including our Lucy mission en route to the asteroid belt, our Sun-watching PUNCH satellites in low Earth orbit, and even the Perseverance Mars rover!\n\nWe unveiled these images today in a live event at NASA's Goddard Space Center, but you can also read the announcement online — and keep an eye on our 3I/ATLAS website for more pics and the latest news updates.",
"text_links": [
"https://www.youtube.com/watch?v=A55SUq2eDXg",
"..."
],
"link": "https://www.reddit.com/user/nasa/comments/1p1iw69/comment/npq8y2k/",
"score": 91,
"iso_date": "2025-11-19T20:31:26Z",
"is_submitter": true
},
"..."
]
}
Removed Post
For a removed post, removed_by says who removed it:
author, moderator or reddit.
A post its author deleted keeps its link, subreddit and comments, without a title or author.
https://www.searchapi.org/api/v1/search?engine=reddit_post&post_id=t3_1wy3nh9
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.org/api/v1/search"
params = {
"engine": "reddit_post",
"post_id": "t3_1wy3nh9"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_aMw9PG4o4X1SalEdokEzRrvY",
"status": "Success",
"created_at": "2026-10-28T16:54:29Z",
"request_time_taken": 2.42,
"parsing_time_taken": 0.0,
"total_time_taken": 2.43,
"request_url": "https://www.reddit.com/comments/1wy3nh9/",
"html_url": "https://www.searchapi.io/api/v1/searches/search_aMw9PG4o4X1SalEdokEzRrvY.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_aMw9PG4o4X1SalEdokEzRrvY"
},
"search_parameters": {
"engine": "reddit_post",
"post_id": "t3_1wy3nh9"
},
"post": {
"id": "t3_1wy3nh9",
"title": "[ Removed by Reddit ]",
"link": "https://www.reddit.com/r/SideProject/comments/1wy3nh9/removed_by_reddit/",
"type": "text",
"author": {
"username": "SamaElmona",
"link": "https://www.reddit.com/user/SamaElmona/"
},
"subreddit": {
"name": "SideProject",
"id": "t5_2w2vn",
"link": "https://www.reddit.com/r/SideProject/",
"icon": "https://styles.redditmedia.com/t5_2w2vn/styles/communityIcon_2rp6f1udtz7g1.png?width=64&frame=1&auto=webp&s=d47d02a7b331fef596d2404f963984eae2342459"
},
"score": 0,
"comments": 0,
"removed_by": "reddit",
"iso_date": "2026-10-05T08:57:21Z"
}
}