Facebook Search Videos API

Endpoint

GET /v1/facebook/videos

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch (1-10, default 1). Billed per page.

start_date

Filter videos from this date (YYYY-MM-DD)

end_date

Filter videos until this date (YYYY-MM-DD)

sort_by

Sort order: most_recent or relevance (default: relevance)

Response fields

videos

Array of matching videos

video_id

Video ID

video_url

Direct link to the video

title

Video title

description

Video description

author_name

Author/page display name

author_url

Author profile or page URL

author_verified

Whether the author is verified

thumbnail

Video thumbnail URL

time_and_views

Time ago and view count text

count

Number of videos returned

pages

Number of pages fetched

Example Request

curl "https://apidirect.io/v1/facebook/videos?query=machine%20learning&start_date=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/facebook/videos",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "machine learning",
        "start_date": "2026-01-01"
    }
)
print(response.json())

Example Response

{
  "videos": [
    {
      "video_id": "7654321098765432",
      "video_url": "https://www.facebook.com/watch/?v=7654321098765432",
      "title": "Introduction to Machine Learning in 2026",
      "description": "A comprehensive overview of the latest machine learning techniques and tools...",
      "author_name": "AI Academy",
      "author_url": "https://www.facebook.com/AIAcademy",
      "author_verified": true,
      "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/...",
      "time_and_views": "2 weeks ago - 340K views"
    },
    {
      "video_id": "8765432109876543",
      "video_url": "https://www.facebook.com/watch/?v=8765432109876543",
      "title": "Machine Learning for Beginners - Full Course",
      "description": "Learn machine learning from scratch with practical examples...",
      "author_name": "Code With Chris",
      "author_url": "https://www.facebook.com/CodeWithChris",
      "author_verified": false,
      "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/...",
      "time_and_views": "1 month ago - 125K views"
    }
  ],
  "count": 2,
  "pages": 1
}

Frequently asked questions

What video data is returned?

Each result includes the video title, description, thumbnail, author name and URL, verification status, and a combined time and views string.

How does date filtering work?

Use start_date and end_date in YYYY-MM-DD format to narrow results to videos published within a specific time range.

How does pagination work?

Use the pages parameter to fetch multiple pages of results in a single request (1-10). Each page is billed separately. Default is 1 page.

How does pricing work?

You only pay for successful requests. The Facebook Search Videos API costs $0.008 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.