superagnt-com

superagnt-com Facebook: Facebook Search API

The Facebook Search API group provides a comprehensive set of endpoints to perform various types of searches across Facebook data, including posts, pages, people, and places. These endpoints enable users to retrieve targeted information based on specific query parameters and filters such as location, user identifiers, and other relevant attributes.

GitHub OpenAPI

Operations 5

GET /v1/data/facebook/search_facebook_watch_videos Fetch Search Videos #
GET /v1/data/facebook/fetch_search_posts Fetch Search Posts #
GET /v1/data/facebook/fetch_search_locations Fetch Search Locations #
GET /v1/data/facebook/fetch_search_people Fetch Search People #
GET /v1/data/facebook/fetch_search_pages Fetch Search Pages #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/superagnt-com/openapi/superagnt-com-facebook-facebook-search-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-agnt-meta-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-bulk-enrich-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-bulk-enrich-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-discover-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-discover-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/superagnt-com/json-schema/superagnt-com-companies-domain-emails-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/superagnt-com:superagnt-com-facebook-facebook-search-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

superagnt-com-facebook-facebook-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 'superagnt Facebook: Facebook Search API'
  description: Unified API for social media data. Access LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook through a single API key.
  version: 1.0.0
  contact:
    name: superagnt
    url: https://superagnt.com
servers:
- url: https://api.superagnt.com
  description: superagnt API
security:
- ApiKeyAuth: []
tags:
- name: 'Facebook: Facebook Search'
  description: The Facebook Search API group provides a comprehensive set of endpoints to perform various types of searches across Facebook data, including posts, pages, people, and places. These endpoints enable users to retrieve targeted information based on specific query parameters and filters such as location, user identifiers, and other relevant attributes.
paths:
  /v1/data/facebook/search_facebook_watch_videos:
    get:
      operationId: Fetch_Search_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.
      tags:
      - 'Facebook: Facebook Search'
      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:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
      - ApiKeyAuth: []
  /v1/data/facebook/fetch_search_posts:
    get:
      operationId: Fetch_Search_Posts
      summary: Fetch Search Posts
      description: This endpoint retrieves information about Facebook Posts based on a specified search query and a location_uid. Use the end_cursor parameter to retrieve additional posts data if needed.
      tags:
      - 'Facebook: Facebook Search'
      parameters:
      - name: start_time
        in: query
        required: false
        schema:
          type: string
      - name: recent_posts
        in: query
        required: false
        schema:
          type: boolean
      - name: end_time
        in: query
        required: false
        schema:
          type: string
      - name: query
        in: query
        required: true
        schema:
          type: string
          default: amsterdam
      - name: end_cursor
        in: query
        required: false
        schema:
          type: string
      - name: location_uid
        in: query
        required: false
        schema:
          type: number
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
      - ApiKeyAuth: []
  /v1/data/facebook/fetch_search_locations:
    get:
      operationId: Fetch_Search_Locations
      summary: Fetch Search Locations
      description: This endpoint retrieves information about Facebook locations based on a specified search query.
      tags:
      - 'Facebook: Facebook Search'
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          default: Paris
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
      - ApiKeyAuth: []
  /v1/data/facebook/fetch_search_people:
    get:
      operationId: Fetch_Search_People
      summary: Fetch Search People
      description: This endpoint retrieves information about Facebook People based on a specified search query and a location_uid. Use the end_cursor parameter to retrieve additional people data if needed.
      tags:
      - 'Facebook: Facebook Search'
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          default: Michael
      - name: end_cursor
        in: query
        required: false
        schema:
          type: string
      - name: location_uid
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
      - ApiKeyAuth: []
  /v1/data/facebook/fetch_search_pages:
    get:
      operationId: Fetch_Search_Pages
      summary: Fetch Search Pages
      description: This endpoint retrieves information about Facebook pages based on a specified search query and a location_uid. Use the end_cursor parameter to retrieve additional pages if needed.
      tags:
      - 'Facebook: Facebook Search'
      parameters:
      - name: location_uid
        in: query
        required: false
        schema:
          type: string
      - name: query
        in: query
        required: true
        schema:
          type: string
          default: cars
      - name: end_cursor
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Unauthorized - invalid API key
        '429':
          description: Rate limit exceeded
      security:
      - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_...'