Search Videos

GET/v1/facebook/search/videos1 credit

Searches Facebook videos by keyword and returns the title, description, author, duration and thumbnail of each.

01Query parameters

Name	Type	Description
queryrequired	string	The search keyword.
cursoroptional	string	The `cursor` from the previous page.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/search/videos?query=nasa+artemis" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/search/videos?query=nasa+artemis

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "nasa artemis",
  "videos": [
    {
      "id": "1862064921793914",
      "url": "https://www.facebook.com/NASA/videos/1862064921793914/",
      "title": "NASA's Artemis III Announcement",
      "description": null,
      "author": {
        "id": "100044561550831",
        "name": "NASA - National Aeronautics and Space Administration",
        "url": "https://www.facebook.com/NASA"
      },
      "creation_time": 1781018706,
      "publish_time": 1781018706,
      "relative_time_text": "Jun 9 · 660 views",
      "duration_ms": 60000,
      "duration_text": "1:00",
      "thumbnail_url": "https://scontent.fist7-2.fna.fbcdn.net/v/t15.5256-10/719301434_1015369264305669_5708030485278968150_n.jpg?stp=c0.0.400.224a_dst-jpg_p75x225_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e3495b&_nc_ohc=QBsAVYUoyJ8Q7kNvwEu0MGH&_nc_oc=AdpdwQ2pwduLEOr8rzOXFJiBGMjUQ8bpcYjBnmfZddKS1sX-2x4gW9ldp2DsoyVfPWCXeGu9-i2OleiMI_Cw2Zzr&_nc_zt=23&_nc_ht=scontent.fist7-2.fna&_nc_gid=q7Oxzcj5KMMbUqPAMeftz…"
    },
    {
      "id": "1724767048954925",
      "url": "https://www.facebook.com/NASA/videos/1724767048954925/",
      "title": "NASA's Artemis III Announcement",
      "description": null,
      "author": {
        "id": "100044561550831",
        "name": "NASA - National Aeronautics and Space Administration",
        "url": "https://www.facebook.com/NASA"
      },
      "creation_time": 1781027670,
      "publish_time": 1781027670,
      "relative_time_text": "Jun 9 · 5 views",
      "duration_ms": 60000,
      "duration_text": "1:00",
      "thumbnail_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t15.5256-10/719754491_1205079148337425_6355070747543069493_n.jpg?stp=c0.0.400.224a_dst-jpg_p75x225_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e3495b&_nc_ohc=a7XPH1NN5mEQ7kNvwFft2Q8&_nc_oc=Adr0OkRy3CEdLtypb5-unN08GSIB__HCvj-aDn01guLhS3tQl6s4DVi6pVv7uZaJj5ZjNREKKMvESPG0_fI-W_uB&_nc_zt=23&_nc_ht=scontent.fist20-1.fna&_nc_gid=q7Oxzcj5KMMbUqPAMef…"
    }
  ],
  "cursor": "eyJ2IjoxLCJxdWVyeSI6Im5hc2EgYXJ0ZW1pcyIsImN1cnNvciI6IntcInBhZ2VfbnVtYmVyXCI6MCxcImZsb3dfY3Vyc29yc19zZXJpYWxpemVkXCI6e1wiSU5URVJOQUxfREVCVUdfTU9EVUxFXCI6XCJ7fVwiLFwiU0VBUkNIX0NPTlRST0xTX0lOVEVSQ0VQVFwiOlwie31cIixcIklOVEVHUklUWVwiOlwie1xcXCJoYXNfbW9yZV9yZXN1bHRzXFxcIjpmYWxzZSxcXFwicHJvY2Vzc2VkX3VuaWNvcm5faWRzXFxcIjpbXSxcXFwiaXNfZW5kX29mX3NlcnBcXFwiOmZhbHNlfVwiLFwiTUVUQV9BSVwiOlwie1xcXCJoYXNfbW9yZV9y…",
  "has_more": true
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Pass the response's `cursor` back for the next page; `has_more` tells whether there is one. A search with no results returns an empty list for 0 credits. `creation_time` and `publish_time` can be null when Facebook shows only a relative date, given in `relative_time_text`.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.