Facebookget/search_facebook_watch_videos

Fetch Search Videos

Facebook Search
Cost / request

$0.01

Response format

JSON

Protocol

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

AI agents that need Facebook data in structured form
Analytics and monitoring pipelines for Facebook content
Research and GTM workflows that combine Facebook signals with other data

Parameters

NameInTypeRequiredDescription
queryquerystringrequiredDefault: dog playing with cats
fieldsquerystringoptionalComma-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_cursorquerystringoptional
videos_livequerybooleanoptional
most_recentquerybooleanoptional

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

$0.01per successful request

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.

Facebook APIFacebook data APIfetch search videos APIAI agents data APIFacebook APIFacebook data APIFacebook for AI agents