Facebook Search Pages API

Endpoint

GET /v1/facebook/pages

Parameters

query *

Search keyword (max 500 characters)

pages

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

Response fields

results

Array of matching pages

name

Page display name

facebook_id

Facebook page ID

url

Page URL

profile_url

Profile page URL

image_url

Profile image URL

is_verified

Whether the page is verified

count

Number of results returned

pages

Number of pages fetched

Example Request

curl "https://apidirect.io/v1/facebook/pages?query=technology" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/facebook/pages",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "technology"}
)
print(response.json())

Example Response

{
  "results": [
    {
      "name": "TechCrunch",
      "facebook_id": "8062627951",
      "url": "https://www.facebook.com/techcrunch",
      "profile_url": "https://www.facebook.com/techcrunch",
      "image_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/...",
      "is_verified": true
    },
    {
      "name": "Technology Review",
      "facebook_id": "35580160073",
      "url": "https://www.facebook.com/technologyreview",
      "profile_url": "https://www.facebook.com/technologyreview",
      "image_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/...",
      "is_verified": true
    }
  ],
  "count": 2,
  "pages": 1
}

Frequently asked questions

What page data is returned?

Each result includes the page name, Facebook ID, URL, profile image, and verification status. Use the Page Details endpoint for more comprehensive data.

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.

Can I use the returned facebook_id with other endpoints?

Yes, the facebook_id can be used as the page_id parameter for endpoints like Page Posts, Page Photos, and Page Reviews.

How does pricing work?

You only pay for successful requests. The Facebook Search Pages 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.