---
title: "Facebook Page Details API"
method: GET
path: "/v1/facebook/page-details"
tags: ["Facebook"]
---

# Facebook Page Details API

`GET /v1/facebook/page-details`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/facebook/page-details`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Facebook page profile — likes vs followers (distinct), talkingAbout, category, website, and public email.

Pass a Facebook page URL, @handle, or page name and get clean JSON: username, displayName (short brand) + fullName (page title), bio, verified, profileImage/coverImage, category, website, and public email when the page exposes one (CRM/outreach-ready). Metrics are distinct: likes, followers, following, and talkingAbout — each count that is present carries its own *IsApproximate flag (followers often a compact chrome label like 28M → followersIsApproximate=true; exact og likes like 28,695,557 → likesIsApproximate=false). Likes are never copied into followers. verified is the badge Facebook shows next to the page name (null when the page header did not render). A handle Facebook does not serve logged-out (non-existent or not public) is 404 at 0 credits. mediaUrlsExpireAt is the earliest expiry of the signed image URLs. Flat 2 credits. Pass cache=true for the 24h shared cache.

Docs: https://captapi.com/apis/facebook-page-details

## Query parameters

- `url` string, required
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `url` string: Canonical URL of the item.
    - `username` string: Account username / handle.
    - `displayName` string: Display name of the account. Canonical across profile endpoints (prefer over name).
    - `fullName` string: Full display name.
    - `bio` string: Profile bio. Canonical across profile endpoints (prefer over description on YouTube).
    - `followers` integer: Follower count.
    - `followersIsApproximate` boolean: True when followers came from a compact chrome label (e.g. 28M). False when Facebook exposed an exact integer.
    - `following` integer: Number of accounts followed.
    - `talkingAbout` integer: Facebook 'people talking about this' count for the page when exposed (distinct from likes/followers).
    - `talkingAboutIsApproximate` boolean: False when talkingAbout is an exact digit string. True when parsed from a compact label.
    - `verified` boolean: Whether the account is verified on this platform.
    - `profileImage` string: Profile image URL. Deprecated alias of avatar on Instagram/Twitter/Threads/TikTok profile endpoints (one release).
    - `coverImage` string: Cover image URL.
    - `category` string: Generic category label for the item or community.
    - `website` string: Website listed on the profile.
    - `email` string: Public email when the Facebook Page About section exposes one. Null when omitted.
    - `mediaUrlsExpireAt` string: ISO-8601 UTC earliest expiry across signed media URLs in this response (expire= / x-expires / TikTok hex path timestamp). Null when no stamp is parseable — never a guess.

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

## Changes

- **2026-10-19** `c9b9ac5ff1bd`: 2 warning, 1 info
  - removed the optional property `data/likes` from the response with the `200` status
  - removed the optional property `data/likesIsApproximate` from the response with the `200` status
  - added the optional property `data/mediaUrlsExpireAt` to the response with the `200` status

[Operation history](https://skmtc.dev/captapi/apis/captapi-api/changes/v1/facebook/page-details/get.md)

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)