# Get Results

Retrieve scraped data from Reddit Scraper

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
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields

Each result object contains the following fields:

<ResponseField name="type" type="string">
  Row type: `post` for the post itself, `comment` for a comment, `user` for a user profile, `subreddit` for subreddit metadata. Example: `post`
</ResponseField>

<ResponseField name="url" type="string">
  Canonical URL of the Reddit post. Example: `https://www.reddit.com/r/Bitcoin/comments/1rcbgsa/crypto_beginners/`
</ResponseField>

<ResponseField name="post_id" type="string">
  Reddit post ID (base36 identifier). Example: `1rcbgsa`
</ResponseField>

<ResponseField name="title" type="string">
  Title of the Reddit post. Example: `Crypto beginners guide`
</ResponseField>

<ResponseField name="body" type="string">
  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.`
</ResponseField>

<ResponseField name="post_type" type="string">
  Type of post: `text`, `image`, `link`, `video`, etc. Example: `text`
</ResponseField>

<ResponseField name="score" type="integer">
  Upvote score of the post or comment. Example: `1842`
</ResponseField>

<ResponseField name="comment_count" type="integer">
  Number of comments on the post. Populated for `type='post'` rows. Example: `126`
</ResponseField>

<ResponseField name="award_count" type="integer">
  Number of awards received by the post. Example: `3`
</ResponseField>

<ResponseField name="author" type="string">
  Username of the post or comment author. Example: `Independent_Lynx715`
</ResponseField>

<ResponseField name="author_id" type="string">
  Reddit ID of the author. Example: `t2_19xe8ly1c0`
</ResponseField>

<ResponseField name="subreddit" type="string">
  Name of the subreddit (without prefix). Example: `Bitcoin`
</ResponseField>

<ResponseField name="subreddit_prefixed_name" type="string">
  Subreddit name with `r/` prefix. Example: `r/Bitcoin`
</ResponseField>

<ResponseField name="subreddit_id" type="string">
  Reddit ID of the subreddit. Example: `t5_3oxtd`
</ResponseField>

<ResponseField name="flair" type="string">
  Post flair label (if any). Example: `Discussion`
</ResponseField>

<ResponseField name="domain" type="string">
  Domain of the post content. `self.xxx` for text posts, or the external domain for link posts. Example: `self.Bitcoin`
</ResponseField>

<ResponseField name="language" type="string">
  Detected language of the post (ISO 639-1). Example: `en`
</ResponseField>

<ResponseField name="created_at" type="string">
  UTC timestamp when the post or comment was created. Example: `2026-04-23T11:16:27`
</ResponseField>

<ResponseField name="comment_id" type="string">
  Reddit comment ID (base36). Populated for `type='comment'` rows only. Example: `ohsv4v5`
</ResponseField>

<ResponseField name="parent_id" type="string">
  Parent comment ID for nested replies. Populated for replies; null for top-level comments and post rows. Example: `ohsv4v5`
</ResponseField>

<ResponseField name="depth" type="integer">
  Comment nesting depth (0 = top-level comment). Null for post rows. Example: `0`
</ResponseField>

<ResponseField name="karma" type="integer">
  Total karma of the user. Populated for `type='user'` rows only. Example: `87`
</ResponseField>

<ResponseField name="post_karma" type="integer">
  Post karma of the user. Populated for `type='user'` rows only. Example: `17`
</ResponseField>

<ResponseField name="comment_karma" type="integer">
  Comment karma of the user. Populated for `type='user'` rows only. Example: `70`
</ResponseField>

<ResponseField name="contributions" type="integer">
  Number of contributions by the user. Populated for `type='user'` rows only. Example: `7`
</ResponseField>

<ResponseField name="trophies" type="string">
  JSON array of trophy names earned by the user. Populated for `type='user'` rows only. Example: `["Five-Year Club"]`
</ResponseField>

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

<ResponseField name="moderated_subreddits" type="string">
  JSON array of subreddits the user moderates (prefixed). Populated for `type='user'` rows only. Example: `["r/belikeme"]`
</ResponseField>

<ResponseField name="subreddit_description" type="string">
  Description of the subreddit. Populated for `type='subreddit'` rows only. Example: `A community dedicated to Bitcoin.`
</ResponseField>

<ResponseField name="weekly_active_users" type="integer">
  Number of weekly active users in the subreddit. Populated for `type='subreddit'` rows only. Example: `1208799`
</ResponseField>

<ResponseField name="weekly_contributions" type="integer">
  Number of weekly contributions (posts + comments) in the subreddit. Populated for `type='subreddit'` rows only. Example: `18683`
</ResponseField>

<ResponseField name="subreddit_rules" type="string">
  JSON array of subreddit rules, each with `number`, `title`, and `description`. Populated for `type='subreddit'` rows only. Example: `[{"number": "1", "title": "Be civil", "description": "..."}]`
</ResponseField>

<ResponseField name="subreddit_resources" type="string">
  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/"}]`
</ResponseField>

<ResponseField name="upvote_ratio" type="float">
  Ratio of upvotes to total votes (0.0–1.0). Populated for post rows. Example: `0.97`
</ResponseField>

<ResponseField name="locked" type="boolean">
  Whether the post has been locked by moderators (no new comments allowed). Example: `false`
</ResponseField>

<ResponseField name="archived" type="boolean">
  Whether the post is archived (older than 6 months; no new votes or comments allowed). Example: `false`
</ResponseField>

<ResponseField name="stickied" type="boolean">
  Whether the post is stickied (pinned) by a moderator. Example: `false`
</ResponseField>

<ResponseField name="over_18" type="boolean">
  Whether the post is marked as NSFW (18+). Example: `false`
</ResponseField>

<ResponseField name="spoiler" type="boolean">
  Whether the post is marked as a spoiler. Example: `false`
</ResponseField>

<ResponseField name="is_video" type="boolean">
  Whether the post is a native Reddit video. Example: `false`
</ResponseField>

<ResponseField name="is_gallery" type="boolean">
  Whether the post contains a gallery of images. Example: `false`
</ResponseField>

<ResponseField name="media_url" type="string">
  Direct URL of the post's media (video or external image). Null for text and self posts.
</ResponseField>

<ResponseField name="thumbnail" type="string">
  Preview thumbnail URL for image and video posts. Null for text posts.
</ResponseField>

<ResponseField name="body_html" type="string">
  HTML-rendered body of the post. Populated only for direct post URL scrapes.
</ResponseField>

<ResponseField name="body_length" type="integer">
  Character count of the plain-text post body. `0` for posts with no body (image, video, link). Example: `342`
</ResponseField>

<ResponseField name="comment_body_html" type="string">
  HTML-rendered body of the comment. Null for non-comment rows.
</ResponseField>

<ResponseField name="age_hours" type="float">
  Age of the post in hours at scraping time, derived from `created_at`. Example: `18.4`
</ResponseField>

<ResponseField name="score_per_hour" type="float">
  Post score divided by age in hours — measures engagement velocity. Example: `245.3`
</ResponseField>

<ResponseField name="comment_to_score_ratio" type="float">
  `comment_count` divided by `max(score, 1)`. High values indicate discussion-heavy posts. Example: `0.08`
</ResponseField>

<ResponseField name="is_high_engagement" type="boolean">
  `true` if `score_per_hour > 50` or `comment_to_score_ratio > 0.1`. Example: `true`
</ResponseField>

<ResponseField name="distinguished_as" type="string">
  Whether the post was made with special authority: `moderator`, `admin`, or null. Example: `null`
</ResponseField>

<ResponseField name="is_promoted" type="boolean">
  Whether the post is a paid advertisement (sponsored/promoted). Example: `false`
</ResponseField>

<ResponseField name="is_self" type="boolean">
  Whether the post is a text/self post (no external link). Example: `true`
</ResponseField>

<ResponseField name="shortlink" type="string">
  Reddit short URL for the post (`https://redd.it/{post_id}`). Example: `https://redd.it/1rcbgsa`
</ResponseField>

<ResponseField name="edited" type="boolean">
  Whether the post or comment has been edited after submission. Example: `false`
</ResponseField>

<ResponseField name="edited_at" type="string">
  ISO timestamp of when the post was last edited. Null if never edited.
</ResponseField>

<ResponseField name="num_crossposts" type="integer">
  Number of times this post has been crossposted to other subreddits. Example: `3`
</ResponseField>

<ResponseField name="author_flair" type="string">
  The post author's flair text in the subreddit at the time of posting. Example: `OG Member`
</ResponseField>

<ResponseField name="author_premium" type="boolean">
  Whether the post or comment author has Reddit Premium. Example: `false`
</ResponseField>

<ResponseField name="gilded" type="integer">
  Number of times this post has been gilded (awarded Reddit Gold). Example: `0`
</ResponseField>

<ResponseField name="is_original_content" type="boolean">
  Whether the post was marked as Original Content (OC) by the author. Example: `false`
</ResponseField>

<ResponseField name="subreddit_subscribers" type="integer">
  Number of subscribers in the subreddit at scraping time. Example: `7234891`
</ResponseField>

<ResponseField name="crosspost_parent_id" type="string">
  The `post_id` of the original post if this is a crosspost. Null otherwise.
</ResponseField>

<ResponseField name="suggested_sort" type="string">
  Sort order suggested by the subreddit moderators for this post's comments. Example: `top`
</ResponseField>

## Response

```json 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
}
```
