Built-in tool
Reddit posts
Get a Reddit post from its URL.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| urlstring · required | string | required | Single Reddit post URL (e.g. reddit.com/r/<sub>/comments/...) — not a subreddit or /s/ share link Example: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"elements"
],
"properties": {
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"photos": {
"type": "array",
"items": {
"type": "string"
}
},
"videos": {
"type": "array",
"items": {
"type": "string"
}
},
"post_id": {
"type": "string"
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"comment": {
"type": [
"string",
"null"
],
"description": "Comment body; null when the source did not deliver it."
},
"replies": {
"type": "array",
"description": "The replies the source loaded for this comment — always an array, possibly empty. Check `replies_truncated`; use \"Collect reddit comments by URL\" for the full tree."
},
"user_url": {
"type": "string"
},
"num_replies": {
"type": "number",
"description": "Replies to this comment as Reddit reports it. Can exceed the entries in `replies` — see `replies_truncated`."
},
"num_upvotes": {
"type": "number"
},
"date_of_comment": {
"type": "string"
},
"user_commenting": {
"type": "string"
},
"replies_truncated": {
"type": [
"boolean",
"null"
],
"description": "True when `num_replies` is greater than the number of entries in `replies`; null when the source gave no reply count."
}
},
"additionalProperties": true
},
"description": "The comments the source loaded for the post — the first page, not necessarily the whole thread. Check `comments_truncated`; use \"Collect reddit comments by URL\" for the full set."
},
"post_karma": {
"type": [
"number",
"null"
],
"description": "Community-level post karma as the source reports it (not this post's score — see `num_upvotes`); null when the source sent an unpopulated 0."
},
"date_posted": {
"type": "string"
},
"description": {
"type": "string"
},
"num_upvotes": {
"type": "number"
},
"user_posted": {
"type": "string"
},
"num_comments": {
"type": "number",
"description": "Total comments on the post as Reddit reports it. Can exceed the number of entries in `comments` — see `comments_truncated`."
},
"related_posts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"community": {
"type": "string"
},
"thumbnail": {
"type": "string"
},
"num_upvotes": {
"type": "number"
},
"num_comments": {
"type": "number"
},
"community_url": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Related Reddit posts, with promoted placements removed."
},
"community_name": {
"type": "string"
},
"community_rank": {
"anyOf": [
{
"type": "object",
"properties": {
"community_rank_type": {
"type": [
"string",
"null"
]
},
"community_rank_value": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
}
},
"additionalProperties": true
},
{
"type": "null"
}
],
"description": "Subreddit rank as the source reports it; null when the source sent none."
},
"comments_returned": {
"type": [
"number",
"null"
],
"description": "Number of entries in `comments`; null when the record carries no comments list."
},
"comments_truncated": {
"type": [
"boolean",
"null"
],
"description": "True when `num_comments` is greater than `comments_returned`, i.e. `comments` is a partial list; null when the record carries no comments list or no usable `num_comments`."
}
},
"additionalProperties": true
}
},
"capReason": {
"enum": [
"tier_default",
"limit_clamped"
],
"type": "string"
},
"recordCap": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"capApplied": {
"type": "boolean"
},
"suggestion": {
"type": "string"
},
"totalElements": {
"type": "number"
}
},
"additionalProperties": true
}
