ToolzerHub Docs

Search videos (v1)

Searches Facebook's public video catalogue by free text and returns matching videos with owner, duration and thumbnail. Paginate with cursor from pageInfo. An empty videos array means no public match.

1 credit / requestBilled only on success
GET
/v1/facebook/search/videos

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

query*string

Free-text search phrase.

Length1 <= length <= 200
cursor?string

Opaque pagination cursor from a previous response.

count?integer

Records per page. Facebook caps most surfaces well below this.

Range1 <= value <= 50
curl -X GET "https://example.com/v1/facebook/search/videos?query=space+launch" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "videos": [      {        "videoId": "string",        "title": "string",        "description": "string",        "url": "string",        "publishedText": "string",        "durationText": "string",        "thumbnailUrl": "string",        "isLive": true,        "owner": {          "id": "string",          "name": "string",          "url": "string",          "isVerified": true        }      }    ],    "pageInfo": {      "cursor": "string",      "hasNextPage": true    }  },  "details": {    "reason": "no_results",    "message": "string"  }}