# API Direct – Facebook Video Search

> API Direct – Facebook Video Search is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-30).

Search Facebook videos by keyword with optional date filtering, sort order, and AI-powered sentiment/emotion analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/facebook/videos?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-facebook-video-search-262e6634
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5AS7vHaC0x6TrnaHojGSe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-facebook-video-search-262e6634
```

Example prompt: Search Facebook videos for 'electric vehicles' posted between 2024-01-01 and 2024-06-30, sorted by most recent, and include AI sentiment analysis on the results — fetch 2 pages.

## When to prefer this

Use this endpoint when you need to search and retrieve Facebook video content by keyword, optionally within a date range and with AI-powered emotional sentiment analysis. Prefer it over general web search when you specifically need Facebook video data. It is especially useful for brand monitoring, content research, news event tracking, or competitive analysis on Facebook's video platform. If you also need sentiment breakdowns beyond simple polarity, the built-in emotion scoring (joy, anger, fear, etc.) makes this a strong choice over plain search endpoints.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Date format errors if start_date or end_date are not in YYYY-MM-DD format
- Pages exceeding maximum of 15 return a validation error
- Facebook-side rate limiting or access restrictions may return partial or empty results
- Query exceeding 500 characters is rejected
- No matching videos returns an empty result set rather than an error

## How this service works

Search for Facebook videos by keyword.

## Output

Returns a merged list of Facebook video results across the requested number of pages, including video metadata (title, URL, view counts, publish date, etc.). When get_sentiment is true, each video also includes a sentiment object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), a dominant_emotion field, emotional_intensity (0-10), and polarity (positive, negative, or neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 15,
       "minimum": 1,
       "description": "Number of pages to fetch and merge into one response (1-15). Billed per page."
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "description": "Search query (max 500 characters)"
      },
      "sort_by": {
       "enum": [
        "most_recent",
        "relevance"
       ],
       "type": "string",
       "default": "relevance",
       "description": "Sort order for results. most_recent returns the newest videos first; relevance is the default."
      },
      "end_date": {
       "type": "string",
       "description": "Filter videos until this date (YYYY-MM-DD)"
      },
      "start_date": {
       "type": "string",
       "description": "Filter videos from this date (YYYY-MM-DD)"
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each video. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any video"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-facebook-video-search-262e6634/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)