API Description

Reddit Search API — Search Reddit content by keyword and return matching results.

Authenticate with your Pangolinfo API Key to receive structured JSON data.

Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/reddit-search

Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.

Request Parameters

ParameterRequiredTypeDescription
targetYesstringTarget URL, supported ID or search keyword for this operation.
optionsNoobjectOptional collection settings, described below.

options Parameters

ParameterRequiredTypeDescription
maxPagesNointegerPages to collect. Default: 1; values above 5 are capped at 5. Must be a positive integer.
Default: 1
Minimum: 1
Maximum: 5
subredditNostringSubreddit name without r/.
sortNostringResult ordering. Supported values are listed below.
tNostringTime range for the selected listing or search sort.
includeOver18NobooleanInclude NSFW content. Default: false.
afterNostring | nullPass pagination.after from the previous response unchanged.
sinceNostring | numberOnly posts published after this ISO date or seconds/milliseconds timestamp.
untilNostring | numberOnly posts published before this date or timestamp, using the same format as since.

Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.

One page by default, capped at five per request. Page counts must be positive integers; higher values are capped at five.

Searches posts only. content is a search snippet rather than the full body; content/snippetId may be null.

Response Fields

FieldTypeDescription
codeintegerStatus code; 0 indicates success.
messagestringResponse message; ok on success.
pointCostnumberPoints charged for this request.
dataobjectCollected data, with fields described below.
metaobjectRequest identifier and duration in milliseconds.
billingobjectCharged units, unit price and billing rule version.

data Fields

FieldTypeDescription
postsobject[]Collected posts.
countnumberNumber of result items.
paginationobjectContinuation cursor and whether more results are available.

data.posts[] Fields

FieldTypeDescription
titlestring | nullTitle
publishedAtobject | nullPublication time.
likesnumber | nullLike count.
commentsCountnumber | nullPlatform-reported comment total; not the number billed.
redditPostIdstringReddit post id
id36string | nullId36
urlstring | nullContent URL.
subredditstring | nullSubreddit name without r/.
over18booleanOver18
spoilerbooleanSpoiler
thumbnailstring | nullThumbnail
previewImagestring | nullPreview image
galleryobject[]Gallery
contentstring | nullContent text; may be null for records without text.
snippetIdstring | nullSnippet id
subredditIdstring | nullSubreddit id
safeSearchstring | nullSafe search
structureTypestring | nullStructure type
subredditNsfwboolean | nullSubreddit nsfw
subredditQuarantinedboolean | nullSubreddit quarantined
actionInfoobject | nullAction info
posterobjectPoster

data.posts[].publishedAt Fields

FieldTypeDescription
textstring | nullText value.
valuenumber | nullParsed value.

data.posts[].gallery[] Fields

FieldTypeDescription
urlstringContent URL.
widthnumber | nullWidth
heightnumber | nullHeight

data.posts[].actionInfo Fields

FieldTypeDescription
positionnumber | nullPosition
relativePositionnumber | nullRelative position
typestring | nullResult type.

data.posts[].poster Fields

FieldTypeDescription
nicknamestring | nullAuthor display name.
profileUrlstring | nullAuthor profile URL.
idstring | nullRecord identifier.

data.pagination Fields

FieldTypeDescription
afterstring | nullPass pagination.after from the previous response unchanged.
hasMorebooleanWhether more results are available.

Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/reddit-search \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "cat"
}'

Response Example

This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.

{
  "code": 0,
  "message": "ok",
  "pointCost": 5.6,
  "data": {
    "posts": [
      {
        "title": "The sweetest boy",
        "publishedAt": {
          "text": "2026-11-01T04:49:26.000Z",
          "value": 1793508566000
        },
        "likes": 40892,
        "commentsCount": 395,
        "redditPostId": "t3_1xkue2d",
        "id36": "1xkue2d",
        "url": "https://www.reddit.com/r/cats/comments/1xkue2d/the_sweetest_boy/",
        "subreddit": "cats",
        "over18": false,
        "spoiler": false,
        "thumbnail": "https://external-preview.redd.it/cXM1ZnZyZ3JseHloMVQVzRAdSxi9LkSs_PMqMdLGYGT9cMAz8h8NwoMTEtSZ.png?width=140&height=78&format=jpg&auto=webp&s=4e1d5ec8d9dd5d1f...",
        "previewImage": "https://external-preview.redd.it/cXM1ZnZyZ3JseHloMVQVzRAdSxi9LkSs_PMqMdLGYGT9cMAz8h8NwoMTEtSZ.png?width=140&height=78&format=jpg&auto=webp&s=4e1d5ec8d9dd5d1f...",
        "gallery": [],
        "content": "People that are saying cats cant show affection are on some stuff bro.",
        "snippetId": "t1_19ryqf8nbs8bo",
        "subredditId": "t5_2qhta",
        "safeSearch": "UNAVAILABLE",
        "structureType": "search",
        "subredditNsfw": false,
        "subredditQuarantined": false,
        "actionInfo": {
          "position": 0,
          "relativePosition": 0,
          "type": null
        },
        "poster": {
          "nickname": "DarthiusFatticus",
          "profileUrl": "https://www.reddit.com/user/DarthiusFatticus/",
          "id": "t2_5t81wgdhd"
        }
      }
    ],
    "count": 7,
    "pagination": {
      "after": "L3N2Yy9zaHJlZGRpdC9zZWFyY2gvP3E9Y2F0JnR5cGU9cG9zdHMmY3Vyc29yPWV5SmpZVzVrYVdSaGRHVnpYM0psZEhWeWJtVmtJam9pZTF3aWMyVmpkR2x2Ymw4eFgzQnBjR1ZzYVc1bFh6QmZaMnh2WW1Gc...",
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-reddit-search-1793954305068487100",
    "durationMs": 2991
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 7,
    "pointCost": 5.6
  }
}

Points Usage

0.8 points per primary result.

Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

Try it