/search_facebook_watch_videosFetch Search Videos
$0.01
JSON
REST
About this endpoint
Access Facebook data through agntdata: Fetch Search Videos. This endpoint retrieves information about Facebook Videos based on a specified search query. Use the end_cursor parameter to paginate through additional video results if more data is available. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need page and group posts, marketplace listings, video content, and ad discovery programmatically.
Use cases
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| query | query | string | required | —Default: dog playing with cats |
| fields | query | string | optional | Comma-separated list of keys to include in the response. Use dot notation to target specific sections (e.g. `videos.id,videos.title,page_info.end_cursor`). Invalid keys are silently ignored. If omitted, the full response is returned. |
| end_cursor | query | string | optional | — |
| videos_live | query | boolean | optional | — |
| most_recent | query | boolean | optional | — |
Responses
Successful response
{
"type": "object"
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "Fetch_Search_Videos",
"method": "get",
"path": "/search_facebook_watch_videos",
"summary": "Fetch Search Videos",
"description": "This endpoint retrieves information about Facebook Videos based on a specified search query. Use the end_cursor parameter to paginate through additional video results if more data is available.",
"parameters": [
{
"name": "query",
"in": "query",
"required": true,
"schema": {
"type": "string",
"default": "dog playing with cats"
}
},
{
"name": "fields",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Comma-separated list of keys to include in the response. Use dot notation to target specific sections (e.g. `videos.id,videos.title,page_info.end_cursor`). Invalid keys are silently ignored. If omitted, the full response is returned."
},
{
"name": "end_cursor",
"in": "query",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "videos_live",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"name": "most_recent",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
}
}
],
"responses": [
{
"statusCode": "200",
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
{
"statusCode": "400",
"description": "Bad request"
},
{
"statusCode": "401",
"description": "Unauthorized - invalid API key"
},
{
"statusCode": "429",
"description": "Rate limit exceeded"
}
]
}Pricing
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Related endpoints
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.