Skip to content
Examples

Get Results

Retrieve scraped data from Reddit Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Reddit Scraper runs. Each result row represents a post, comment, user profile, or subreddit — indicated by the type field.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

typestring

Row type: post for the post itself, comment for a comment, user for a user profile, subreddit for subreddit metadata. Example: post

urlstring

Canonical URL of the Reddit post. Example: https://www.reddit.com/r/Bitcoin/comments/1rcbgsa/crypto_beginners/

post_idstring

Reddit post ID (base36 identifier). Example: 1rcbgsa

titlestring

Title of the Reddit post. Example: Crypto beginners guide

bodystring

Text body of the post (for text posts) or comment text (for comment rows). Example: Here's everything you need to know as a beginner.

post_typestring

Type of post: text, image, link, video, etc. Example: text

scoreinteger

Upvote score of the post or comment. Example: 1842

comment_countinteger

Number of comments on the post. Populated for type='post' rows. Example: 126

award_countinteger

Number of awards received by the post. Example: 3

authorstring

Username of the post or comment author. Example: Independent_Lynx715

author_idstring

Reddit ID of the author. Example: t2_19xe8ly1c0

subredditstring

Name of the subreddit (without prefix). Example: Bitcoin

subreddit_prefixed_namestring

Subreddit name with r/ prefix. Example: r/Bitcoin

subreddit_idstring

Reddit ID of the subreddit. Example: t5_3oxtd

flairstring

Post flair label (if any). Example: Discussion

domainstring

Domain of the post content. self.xxx for text posts, or the external domain for link posts. Example: self.Bitcoin

languagestring

Detected language of the post (ISO 639-1). Example: en

created_atstring

UTC timestamp when the post or comment was created. Example: 2026-04-23T11:16:27

comment_idstring

Reddit comment ID (base36). Populated for type='comment' rows only. Example: ohsv4v5

parent_idstring

Parent comment ID for nested replies. Populated for replies; null for top-level comments and post rows. Example: ohsv4v5

depthinteger

Comment nesting depth (0 = top-level comment). Null for post rows. Example: 0

karmainteger

Total karma of the user. Populated for type='user' rows only. Example: 87

post_karmainteger

Post karma of the user. Populated for type='user' rows only. Example: 17

comment_karmainteger

Comment karma of the user. Populated for type='user' rows only. Example: 70

contributionsinteger

Number of contributions by the user. Populated for type='user' rows only. Example: 7

trophiesstring

JSON array of trophy names earned by the user. Populated for type='user' rows only. Example: ["Five-Year Club"]

active_subredditsstring

JSON array of subreddits the user is active in (prefixed). Populated for type='user' rows only. Example: ["r/Bitcoin", "r/PostCardExchange"]

moderated_subredditsstring

JSON array of subreddits the user moderates (prefixed). Populated for type='user' rows only. Example: ["r/belikeme"]

subreddit_descriptionstring

Description of the subreddit. Populated for type='subreddit' rows only. Example: A community dedicated to Bitcoin.

weekly_active_usersinteger

Number of weekly active users in the subreddit. Populated for type='subreddit' rows only. Example: 1208799

weekly_contributionsinteger

Number of weekly contributions (posts + comments) in the subreddit. Populated for type='subreddit' rows only. Example: 18683

subreddit_rulesstring

JSON array of subreddit rules, each with number, title, and description. Populated for type='subreddit' rows only. Example: [{"number": "1", "title": "Be civil", "description": "..."}]

subreddit_resourcesstring

JSON array of community resource links, each with text and url. Populated for type='subreddit' rows only. Example: [{"text": "Wiki", "url": "https://www.reddit.com/r/Bitcoin/wiki/"}]

upvote_ratiofloat

Ratio of upvotes to total votes (0.0–1.0). Populated for post rows. Example: 0.97

lockedboolean

Whether the post has been locked by moderators (no new comments allowed). Example: false

archivedboolean

Whether the post is archived (older than 6 months; no new votes or comments allowed). Example: false

stickiedboolean

Whether the post is stickied (pinned) by a moderator. Example: false

over_18boolean

Whether the post is marked as NSFW (18+). Example: false

spoilerboolean

Whether the post is marked as a spoiler. Example: false

is_videoboolean

Whether the post is a native Reddit video. Example: false

is_galleryboolean

Whether the post contains a gallery of images. Example: false

media_urlstring

Direct URL of the post's media (video or external image). Null for text and self posts.

thumbnailstring

Preview thumbnail URL for image and video posts. Null for text posts.

body_htmlstring

HTML-rendered body of the post. Populated only for direct post URL scrapes.

body_lengthinteger

Character count of the plain-text post body. 0 for posts with no body (image, video, link). Example: 342

comment_body_htmlstring

HTML-rendered body of the comment. Null for non-comment rows.

age_hoursfloat

Age of the post in hours at scraping time, derived from created_at. Example: 18.4

score_per_hourfloat

Post score divided by age in hours — measures engagement velocity. Example: 245.3

comment_to_score_ratiofloat

comment_count divided by max(score, 1). High values indicate discussion-heavy posts. Example: 0.08

is_high_engagementboolean

true if score_per_hour > 50 or comment_to_score_ratio > 0.1. Example: true

distinguished_asstring

Whether the post was made with special authority: moderator, admin, or null. Example: null

is_promotedboolean

Whether the post is a paid advertisement (sponsored/promoted). Example: false

is_selfboolean

Whether the post is a text/self post (no external link). Example: true

shortlinkstring

Reddit short URL for the post (https://redd.it/{post_id}). Example: https://redd.it/1rcbgsa

editedboolean

Whether the post or comment has been edited after submission. Example: false

edited_atstring

ISO timestamp of when the post was last edited. Null if never edited.

num_crosspostsinteger

Number of times this post has been crossposted to other subreddits. Example: 3

author_flairstring

The post author's flair text in the subreddit at the time of posting. Example: OG Member

author_premiumboolean

Whether the post or comment author has Reddit Premium. Example: false

gildedinteger

Number of times this post has been gilded (awarded Reddit Gold). Example: 0

is_original_contentboolean

Whether the post was marked as Original Content (OC) by the author. Example: false

subreddit_subscribersinteger

Number of subscribers in the subreddit at scraping time. Example: 7234891

crosspost_parent_idstring

The post_id of the original post if this is a crosspost. Null otherwise.

suggested_sortstring

Sort order suggested by the subreddit moderators for this post's comments. Example: top

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 81473,
      "object": "result",
      "squid": "23d48753dff0014766ec0db16c053cd1",
      "run": "3a9ec8b1a9662d20fff061f98e5dc26b",
      "type": "post",
      "url": "https://www.reddit.com/r/developpeurs/comments/1stfrij/pourquoi_y_atil_si_peu_de_femmes_en_informatique/",
      "post_id": "1stfrij",
      "title": "Pourquoi y a-t-il si peu de femmes en informatique ?",
      "body": "Je bosse dans une ESN, ~1000 personnes. On est facilement à 90% d'hommes dans les équipes tech.",
      "post_type": "text",
      "score": 19,
      "comment_count": 126,
      "award_count": 0,
      "author": "Independent_Lynx715",
      "author_id": "t2_19xe8ly1c0",
      "subreddit": "developpeurs",
      "subreddit_prefixed_name": "r/developpeurs",
      "subreddit_id": "t5_3oxtd",
      "flair": "Carrière",
      "domain": "self.developpeurs",
      "language": "fr",
      "created_at": "2026-04-23T11:16:27",
      "comment_id": "ohsv4v5",
      "parent_id": "ohsv4v5",
      "depth": 0,
      "karma": 87,
      "post_karma": 17,
      "comment_karma": 70,
      "contributions": 7,
      "trophies": "[\"Five-Year Club\"]",
      "active_subreddits": "[\"r/Bitcoin\", \"r/PostCardExchange\"]",
      "moderated_subreddits": "[\"r/belikeme\"]",
      "subreddit_description": "A community dedicated to sharing...",
      "weekly_active_users": 1208799,
      "weekly_contributions": 18683,
      "subreddit_rules": "[{\"number\": \"1\", \"title\": \"Be civil\", \"description\": \"...\"}]",
      "subreddit_resources": "[{\"text\": \"Wiki\", \"url\": \"https://www.reddit.com/r/example/wiki/\"}]",
      "upvote_ratio": 0.95,
      "locked": false,
      "archived": false,
      "stickied": false,
      "over_18": false,
      "spoiler": false,
      "is_video": false,
      "is_gallery": false,
      "media_url": "https://v.redd.it/abtj8w6xf7ah1",
      "thumbnail": "https://external-preview.redd.it/example.png",
      "body_html": "<p>Post body as HTML</p>",
      "body_length": 142,
      "comment_body_html": "<p>Great point, thanks for sharing!</p>",
      "age_hours": 3.75,
      "score_per_hour": 127.4,
      "comment_to_score_ratio": 0.312,
      "is_high_engagement": true,
      "distinguished_as": "moderator",
      "is_promoted": false,
      "is_self": true,
      "shortlink": "https://redd.it/abc123",
      "edited": false,
      "edited_at": "2026-01-15T10:30:00",
      "num_crossposts": 3,
      "author_flair": "Top Contributor",
      "author_premium": false,
      "gilded": 0,
      "is_original_content": false,
      "subreddit_subscribers": 1250000,
      "crosspost_parent_id": "xyz789",
      "suggested_sort": "top",
      "functions": null,
      "native_id": 81473
    }
  ],
  "next": null,
  "previous": null
}