Facebook profile API

Facebook Profile API

Exact follower count for a public Facebook Page or personal profile; a Page also returns its name, category and verified badge. Send a public URL and get the fields in the same terms the platform uses.

Input: Public Facebook profile URL. Returns: one object, in Facebook's own field names. Price: 1 credit per call; failed reads are free.

Try this API Read reference

GET /v1/facebook/profile Public Facebook profile URL · One object

Illustrative response

GET /v1/facebook/profile

URL url=https://www.facebook.com/NASA

Each call1 credit

Retrieval failurefree

{
  "success": true,
  "available": true,
  "creditsCharged": 1,
  "data": {
    "name": "NASA - National Aeronautics and Space Administration",
    "category": "Government organization",
    "verified": true,
    "followerCount": 28700000,
    "followingCount": 120,
    "fetchedAt": "2026-08-28T09:41:44Z"
  }
}

Key fields shown · full response below

See it in action

Try it with a sample URL.

The snippets use the production endpoint. Replace the sample URL with your own public target before running them.

Try this API live

Pick a sample input

Start from a valid shape, then replace the sample value with your public target.

Selected https://www.facebook.com/NASA Open

Preview the request

Use a server-side key and send parameters as query values.

GET https://api.sourcevine.io/v1/facebook/profile

curl -G 'https://api.sourcevine.io/v1/facebook/profile' \
  -H 'Authorization: Bearer sv_live_...' \
  --data-urlencode 'url=https://www.facebook.com/NASA'

const params = new URLSearchParams({
  "url": "https://www.facebook.com/NASA",
});

const res = await fetch('https://api.sourcevine.io/v1/facebook/profile?' + params, {
  headers: { Authorization: 'Bearer sv_live_...' },
});

const body = await res.json();
console.log(body.data);

import requests

r = requests.get(
    "https://api.sourcevine.io/v1/facebook/profile",
    params={"url": "https://www.facebook.com/NASA"},
    headers={"Authorization": "Bearer sv_live_..."},
)

body = r.json()
print(body["data"])

Shows an illustrative response. Nothing leaves your browser.

Read the response

Every success includes availability, a fetch timestamp and billing context.

GET /v1/facebook/profile Not run

Hit Show sample response to see the response.

An illustrative response. This endpoint has no verified capture yet.

available 1 credit illustrative

Followers28,700,000

Following120

Cost1 credit

{
  "success": true,
  "available": true,
  "data": {
    "url": "https://www.facebook.com/NASA",
    "pageId": "100044561550831",
    "username": "NASA",
    "name": "NASA - National Aeronautics and Space Administration",
    "category": "Government organization",
    "avatarUrl": "https://cdn.sourcevine.io/avatar/facebook-example.jpg",
    "verified": true,
    "followerCount": 28700000,
    "followingCount": 120,
    "fetchedAt": "2026-08-28T09:41:44Z",
    "sourceTimestamp": "2026-08-27T18:04:12Z",
    "cached": false,
    "cacheAgeSeconds": 0
  }
}

Ship it anywhere

Use this API from code, no-code tools, MCP clients and agents.

We build and maintain theseFirst-party surfaces, versioned with the API.

HTTP Any backend, worker or cron job MCP Available as a tool in npx @sourcevine/mcp

Works anywhere that can make an HTTP requestNo plugin to install, and none to wait for.

Make HTTP → Make a request Zapier Webhooks by Zapier → Custom Request n8n HTTP Request node Agents Scoped reads for a tool-using model

Response

Response fields.

Each response includes typed availability, a fetch timestamp, and only the public fields this API promises.

Field	Type	Meaning
url	string	The public Page or profile URL you sent.
pageId	string	Facebook id of the Page or profile.
username	string \| null	The Page's username.
name	string \| null	Page name. Null for a personal profile.
category	string \| null	Page category as Facebook shows it. Null for a personal profile.
avatarUrl	string \| null	Page profile picture. Null for a personal profile.
verified	boolean \| null	Whether the Page carries a verified badge. Null for a personal profile.
followerCount	integer \| null	Exact public follower count, for a Page or a personal profile.
followingCount	integer \| null	Accounts the Page follows, where Facebook shows it.
fetchedAt	ISO datetime	When Sourcevine read the public page.
sourceTimestamp	ISO datetime \| null	The platform timestamp when it is available.
cached	boolean	True when this answer repeats an identical request made moments earlier.
cacheAgeSeconds	integer	Seconds since the reading was taken.

Request flow

How a request is handled.

01 Send a public URL
Send a public Facebook profile URL. Sourcevine resolves ids, validates the resource type and returns a typed response.
02 Checked
A URL of the wrong kind or platform is refused with a 400 before any fetch, and not charged.
03 Read
The public data is read when you call. An identical request moments earlier is answered again, free.
04 Unavailable is checked twice
Facebook shows the same "This content isn’t available" page for content that is missing, deleted, private or blocked in a region. When a second check confirms that page, the call reports not found and is charged like any lookup. It is never reported as private, because the page does not say which case it is. If we cannot confirm it, the call returns 503 and is not charged.
05 JSON back
Facebook names stay intact, so your code reads followerCount instead of reverse-engineering a generic schema.

fetchedAtcreditsChargedavailable

Every response carries fetchedAt and the platform timestamp, so you know how old a reading is before you act on it. Facebook Profile API fits recurring profile checks in dashboards, spreadsheets, workflows and agents.

Boundaries

What this API does not return.

No contact or bio fields
Bios, email addresses, phone numbers, postal addresses and messenger handles are outside the response contract.
Personal profiles are counts only
For a personal profile the response carries the follower count and id. Name, category, avatar and verified badge are returned for Pages only.
No groups, stories or events
Groups, stories and events are not supported: those URLs are refused with a 400 before any fetch, and not charged.

Use cases

Where teams use Facebook Profile API.

Creator qualification

Check the public follower count of a creator’s Page or profile before inviting them.

CRM enrichment

Attach public profile metrics to a contact, account or opportunity record.

Growth tracking

Refresh public profile counters on a schedule and keep the history yourself.

Page tracking

Record a public Page’s exact follower count on a schedule, alongside its category and verified badge.

Pricing

1 credit per call, and nothing for a failed read.

The response and X-Credits-Charged header tell you what happened, including when it is zero.

Charged1 credit

AnsweredThe public data came back.
Not foundFacebook did not show the content on two checks: missing, deleted, private or blocked in a region.
Empty resultThe lookup was made and found nothing to return, such as an account with no posts.

Not charged0 credits

Failure on our sideA read we could not complete or confirm returns 503.
Unsupported URLThe wrong kind of URL, or a group, story or event: refused before any fetch.
Cache hitAn identical request moments earlier, answered again.

FAQ

Common questions.

What does Facebook Profile API return?

Exact follower count for a public Facebook Page or personal profile; a Page also returns its name, category and verified badge.

How is it billed?

A call costs 1 credit, including an empty result. Retrieval failures are not charged.

What happens when the post or profile is private or deleted?

Facebook shows the same "This content isn’t available" page for content that is missing, deleted, private or blocked in a region. When a second check confirms that page, the call reports not found and is charged like any lookup. It is never reported as private, because the page does not say which case it is. If we cannot confirm it, the call returns 503 and is not charged.

Does Sourcevine return contact data?

No. Bios, emails, phone numbers, postal addresses and private or restricted content are outside the public response contract.

Do I need to log in to Facebook?

No. Your integration authenticates with a Sourcevine API key. You do not need to supply Facebook credentials or a session.