​
API Description

Facebook Search API — Search Facebook 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/facebook-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
cursorNostring | nullContinuation cursor from the previous response. Pass the value unchanged.
sortNostringResult ordering. Supported values are listed below.
Values: [“relevance”, “recent”]
timeRangeNostringPublication time filter. Omit to retain the URL filter.
Values: [“all”, “day”, “week”, “month”]

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 videos only.

​
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
querystringQuery
itemsobject[]Result items.
paginationobjectContinuation cursor and whether more results are available.

​
data.items[] Fields

FieldTypeDescription
videoIdstringVideo id
postIdstring | nullPost id
storyIdstring | nullStory id
rolestring | nullRole
urlstring | nullContent URL.
messagestring | nullResponse message; ok on success.
ownerobjectOwner
publishedAtobject | nullPublication time.
relativeTimeTextstring | nullRelative time text
durationMsnumber | nullDuration in milliseconds.
widthnumber | nullWidth
heightnumber | nullHeight
thumbnailUrlstring | nullThumbnail url
reactionCountnumber | nullReaction count
commentCountnumber | nullComment count
shareCountnumber | nullShare count
viewCountnumber | nullView count

​
data.items[].owner Fields

FieldTypeDescription
idstring | nullRecord identifier.
namestring | nullName
typestring | nullResult type.

​
data.items[].publishedAt Fields

FieldTypeDescription
textstring | nullText value.
valuenumber | nullParsed value.

​
data.pagination Fields

FieldTypeDescription
cursorstring | nullContinuation cursor from the previous response. Pass the value unchanged.
hasMorebooleanWhether more results are available.

​
Request Example

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/facebook-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": 4.0,
  "data": {
    "query": "cat",
    "items": [
      {
        "videoId": "2209432039635892",
        "postId": "122193904496842774",
        "storyId": "UzpfSTYxNTc1MjgzMjI1ODYxOlZLOjIyMDk0MzIwMzk2MzU4OTI=",
        "role": "VIDEOS_MBR_ENGAGEMENT",
        "url": "https://www.facebook.com/reel/2209432039635892/",
        "message": "“To the world you may be one person, but to one person you may be the world” 🐈‍⬛🐈💖\n.\nBoth Baba and Yaga are very cuddly in general; however, sometimes Baba g...",
        "owner": {
          "id": "61575283225861",
          "name": "BabaYaga Cat",
          "type": "User"
        },
        "publishedAt": {
          "text": "2026-11-04T12:10:12.000Z",
          "value": 1793794212000
        },
        "relativeTimeText": null,
        "durationMs": 30400,
        "width": 1080,
        "height": 1920,
        "thumbnailUrl": "https://scontent.fdxb2-1.fna.fbcdn.net/v/t51.82787-10/879428335_17936933163417778_8617318399828117111_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_...",
        "reactionCount": 6613,
        "commentCount": 139,
        "shareCount": 117,
        "viewCount": 24479
      }
    ],
    "pagination": {
      "cursor": null,
      "hasMore": true
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-facebook-search-1793954265337132700",
    "durationMs": 22047
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 5,
    "pointCost": 4.0
  }
}

​
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