Facebook · Guide

How to get Facebook page details

TL;DR

To get Facebook page details, sign up for a free Captapi key, then send one GET request to /v1/facebook/page-details with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email.

Get your free API key API reference

How to get Facebook page details (step by step)

1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
2
Call the Facebook Page Details API
Send an authenticated GET request to /v1/facebook/page-details with your input. No OAuth, no scraping setup.
3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/facebook/page-details?url=https%3A%2F%2Fwww.facebook.com%2FNASA%2F" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "facebook",
    "url": "https://www.facebook.com/NASA/",
    "username": "NASA",
    "displayName": "NASA",
    "fullName": "NASA - National Aeronautics and Space Administration",
    "bio": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
    "followers": 28747189,
    "followersIsApproximate": false,
    "following": 52,
    "talkingAbout": 354079,
    "talkingAboutIsApproximate": false,
    "verified": true,
    "profileImage": "https://scontent-lis1-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=1&ccb=1-7&_nc_sid=f907e8&_nc_ohc=nV2Uf3NeHP8Q7kNvwH8SgEo&_nc_oc=AdpBDiMEiY6Rkcw1JNA7NKdyTXSGlFtDfJecGo6j5-pzwBglBkJdYxBt_9TnTnbQQDM&_nc_zt=24&_nc_ht=scontent-lis1-1.xx&_nc_gid=EY51xnMFCasKtUQuQQRh_A&_nc_ss=7b289&oh=00_AQNZVsKvWZmWOBgVrwpvkS5pHuRB0I73SjRpEkcj651W7g&oe=6ADC0815",
    "coverImage": "https://scontent-lis1-1.xx.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_tt6&cstp=mx2047x1487&ctp=s960x960&_nc_cat=110&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=Qu8GKdw8KQwQ7kNvwFSqq8m&_nc_oc=AdozbxEIB8O57ZiFkmkIIYF9TdNjEKlEPnO4R3-9dazUynMl5q8BFsEoj_CXKKqzcQc&_nc_zt=14&_nc_ht=scontent-lis1-1.xx&_nc_gid=EY51xnMFCasKtUQuQQRh_A&_nc_ss=7b289&oh=00_AQMj9oAjVXm1cjYDVScUg3AP5-6sWUSXPjimZ4ePQ25P2A&oe=6ADC0BE7",
    "category": "Government organization",
    "website": "https://nasa.gov/nasa-app",
    "email": "public-inquiries@hq.nasa.gov",
    "mediaUrlsExpireAt": "2026-10-24T01:21:25.000Z"
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

Name	Type	Required	Description
url	string	Yes	Facebook page URL, @handle, or page name, e.g. https://facebook.com/PageName. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cache	boolean	No	Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Frequently asked questions

What does the Facebook Page Details API do?

The Facebook Page Details API lets you fetch profile or page details and audience stats from a public Facebook profile or page using one GET request to /v1/facebook/page-details. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Facebook Page Details API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Facebook API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle access, rate limits, retries, and authentication for you.

Is the Facebook Page Details API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Facebook page details?

Start free with 100 credits — no credit card required.

Get your free API key