100 free credits - no credit card required

Facebook Scraper API

Facebook API: 29 endpoints for public Facebook data through the SocialQuery response format. One x-api-key header, generated docs, and normalized JSON alongside 67 other platforms.

Dashboard View Documentation

TL;DR

The Facebook API by SocialQuery returns public Facebook data as structured JSON through 29 endpoints with one shared response envelope.

Where to find SocialQuery

OpenAPI specification Integration guide API documentation

Live demo

Try the Facebook API in your browser

Type a public Facebook handle, URL, or query, run a real request, and inspect the JSON SocialQuery returns.

Try the Facebook Profile API

See real data before writing a single line

Endpoints

What data does the Facebook API return?

Every Facebook endpoint returns structured JSON with request metadata, credit usage, cache information, and normalized fields.

Profilestandard

Facebook profile. Availability depends on the configured provider route.

Profile Postsstandard

Facebook profile posts. Availability depends on the configured provider route.

Poststandard

Facebook post. Availability depends on the configured provider route.

Post Commentsstandard

Facebook post comments. Availability depends on the configured provider route.

Group Postsstandard

Facebook group posts. Availability depends on the configured provider route.

Groupstandard

Facebook group. Availability depends on the configured provider route.

Post Transcriptpremium

Facebook post transcript. Availability depends on the configured provider route.

Profile Photosstandard

Facebook profile photos. Availability depends on the configured provider route.

Profile Reelsstandard

Facebook profile reels. Availability depends on the configured provider route.

Adlibrary Adadvanced

Facebook adlibrary ad. Availability depends on the configured provider route.

Adlibrary Company Adsadvanced

Facebook adlibrary company ads. Availability depends on the configured provider route.

Adlibrary Search Adsadvanced

Facebook adlibrary search ads. Availability depends on the configured provider route.

Adlibrary Search Companiesadvanced

Facebook adlibrary search companies. Availability depends on the configured provider route.

Profile Eventsstandard

Facebook profile events. Availability depends on the configured provider route.

Post Comment Repliesstandard

Facebook post comment replies. Availability depends on the configured provider route.

Marketplace Location Searchstandard

Facebook marketplace location search. Availability depends on the configured provider route.

Marketplace Searchstandard

Facebook marketplace search. Availability depends on the configured provider route.

Marketplace Itemstandard

Facebook marketplace item. Availability depends on the configured provider route.

Events Searchstandard

Facebook events search. Availability depends on the configured provider route.

Eventsstandard

Facebook events. Availability depends on the configured provider route.

Event Detailsstandard

Facebook event details. Availability depends on the configured provider route.

Adlibrary Ad Transcriptpremium

Facebook adlibrary ad transcript. Availability depends on the configured provider route.

Profile Fulladvanced

Facebook profile full. Availability depends on the configured provider route.

Profile Reels Fulladvanced

Facebook profile reels full. Availability depends on the configured provider route.

Search Postsstandard

Facebook search posts. Availability depends on the configured provider route.

Search Pagesstandard

Facebook search pages. Availability depends on the configured provider route.

Search Peoplestandard

Facebook search people. Availability depends on the configured provider route.

Search Videosstandard

Facebook search videos. Availability depends on the configured provider route.

Search Groupsstandard

Facebook search groups. Availability depends on the configured provider route.

Developer First

How do you scrape Facebook data in seconds?

Scrape public Facebook data without maintaining source-specific routing, parsing, retries, or response adapters.

One schema, every platform

Query 68 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement, content, cache, and request metadata ready for dashboards.

See your data before you code

Run browser demos, copy request snippets, and inspect JSON before moving into production.

PythonTypeScript{ }cURL

import requests

response = requests.get(
    'https://socialquery.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sq_YOUR_API_KEY'}
)
data = response.json()

const response = await fetch(
  'https://socialquery.dev/v1/tiktok/profile?handle=charlidamelio',
  {
    headers: {
      'x-api-key': 'sq_YOUR_API_KEY'
    }
  }
);

const data = await response.json();

curl 'https://socialquery.dev/v1/tiktok/profile?handle=charlidamelio' \
  -H 'x-api-key: sq_YOUR_API_KEY'

import requests

response = requests.get(
    'https://socialquery.dev/v1/instagram/profile',
    params={'handle': 'mkbhd'},
    headers={'x-api-key': 'sq_YOUR_API_KEY'}
)
data = response.json()

const response = await fetch(
  'https://socialquery.dev/v1/instagram/profile?handle=mkbhd',
  {
    headers: {
      'x-api-key': 'sq_YOUR_API_KEY'
    }
  }
);

const data = await response.json();

curl 'https://socialquery.dev/v1/instagram/profile?handle=mkbhd' \
  -H 'x-api-key: sq_YOUR_API_KEY'

import requests

response = requests.get(
    'https://socialquery.dev/v1/youtube/channel',
    params={'handle': '@mkbhd'},
    headers={'x-api-key': 'sq_YOUR_API_KEY'}
)
data = response.json()

const response = await fetch(
  'https://socialquery.dev/v1/youtube/channel?handle=@mkbhd',
  {
    headers: {
      'x-api-key': 'sq_YOUR_API_KEY'
    }
  }
);

const data = await response.json();

curl 'https://socialquery.dev/v1/youtube/channel?handle=@mkbhd' \
  -H 'x-api-key: sq_YOUR_API_KEY'

import requests

response = requests.get(
    'https://socialquery.dev/v1/reddit/subreddit',
    params={'name': 'saas'},
    headers={'x-api-key': 'sq_YOUR_API_KEY'}
)
data = response.json()

const response = await fetch(
  'https://socialquery.dev/v1/reddit/subreddit?name=saas',
  {
    headers: {
      'x-api-key': 'sq_YOUR_API_KEY'
    }
  }
);

const data = await response.json();

curl 'https://socialquery.dev/v1/reddit/subreddit?name=saas' \
  -H 'x-api-key: sq_YOUR_API_KEY'

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

{
  "success": true,
  "platform": "instagram",
  "data": {
    "author": {
      "username": "mkbhd",
      "followers": 5240000
    },
    "engagement": {
      "likes": 178000,
      "engagement_rate": 0.034
    },
    "metadata": {
      "language": "en",
      "content_category": "tech"
    }
  }
}

{
  "success": true,
  "platform": "youtube",
  "data": {
    "channel": {
      "handle": "@mkbhd",
      "subscribers": 19400000
    },
    "engagement": {
      "avg_views": 4200000,
      "engagement_rate": 0.062
    },
    "metadata": {
      "language": "en",
      "content_category": "tech"
    }
  }
}

{
  "success": true,
  "platform": "reddit",
  "data": {
    "subreddit": {
      "name": "saas",
      "subscribers": 412000
    },
    "engagement": {
      "posts_24h": 47,
      "top_post_upvotes": 1240
    },
    "metadata": {
      "language": "en",
      "content_category": "business"
    }
  }
}

TikTokInstagramYouTubeReddit+ 68 platforms

One API, 68 platforms

How does SocialQuery handle 68 different platforms?

Facebook has its own URLs, naming, pagination, freshness, and response quirks. SocialQuery turns those details into one API contract.

One schema, every platform

Write once, query them all.

68 platforms return different JSON shapes. SocialQuery normalizes each response into one consistent structure.

success: true
platform: unified
credits_used: 1

Metrics ready before you parse

Fields ready for products.

Every response carries request ids, cache state, credit usage, computed metadata, and source-specific fields in one envelope.

success: true
platform: unified
credits_used: 1

One key, every platform

One auth, every source.

Keep a single server-side key and route public-data workflows across social, reviews, search, commerce, and developer platforms.

success: true
platform: unified
credits_used: 1

Pagination handled

Batch, enrich, and scale.

Endpoint docs expose cost, cache, params, and pagination behavior before a request runs.

success: true
platform: unified
credits_used: 1

Dashboard

Facebook API29 endpoints supported

View docs

GET/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta

url

curl -X GET 'https://socialquery.dev/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FMeta' \
  -H "x-api-key: $SOCIALQUERY_API_KEY"

- · idle

// Edit the params above and hit "Try it" to run a live request against the API

Compare

How does SocialQuery compare to official Facebook API for Facebook data?

SocialQuery is built for teams that need Facebook data through one key, one schema, generated docs, and cross-platform workflows.

FeatureSocialQueryOfficial API

AuthenticationOne x-api-key headerOAuth, app scopes, review, and rate tiers

Setup requiredSign up and call an endpointDeveloper app registration and product approval

Data accessPublic Facebook workflows, normalized fieldsPlatform-specific permitted endpoints

Response schemaUnified across platformsNative source-specific JSON

PricingPay per successful API callOften quota, review, or contract dependent

MaintenanceSchema docs update with API changesYour team owns adapters and normalization

How much does Facebook scraping cost?

Most standard endpoints start at 1 credit per successful call. Endpoint pages list the exact credit cost, cache window, and parameters before you run a request.

Is Facebook scraping legal?

Use public data, respect source rules, and design retention and downstream processing around your jurisdiction and customer-approved use case.

FAQ

Have a question? We got answers

Find answers to commonly asked questions about this SocialQuery API, pricing, and production use.

How do I scrape Facebook data with an API?

Create a key, choose one of the Facebook endpoint pages, pass the required parameters, and read the normalized SocialQuery response envelope.

What does the SocialQuery Facebook API cover?

This page exposes 29 generated endpoint pages for public Facebook workflows.

How much does the Facebook API cost?

Each endpoint card and API reference operation lists the live-call credit cost and cache window before you run a request.

Is scraping Facebook data legal?

Legality depends on source rules, jurisdiction, and use case. Build around public data, responsible retention, and documented customer authorization.

Can I use the Facebook API in production?

Provider coverage is rolling out during preview. Test your required endpoint before integrating it into a production workflow.

What is the best Facebook scraper API?

For teams that need normalized public data across many platforms, SocialQuery gives one API contract instead of separate source-specific scrapers.

Live data & statistics

Public Facebook API stats and cost details are generated from the current SocialQuery catalog.

Facebook endpoints

starting credits

30 minutes

sample cache

Ready to start scraping Facebook data?

Get your API key and start with 100 free credits. Try live endpoints in under 60 seconds.

Dashboard