# Facebook Profile API (https://www.socialcrawl.dev/platforms/facebook/profile)

> Returns a unified Facebook Author profile with page ID, display name, profile URL, profile image, bio (the page intro), follower count, page-like count, and creation date. Two things to know before grading on the numbers: `author.followers` is Facebook's ROUNDED public display figure (106,000,000 on the Meta page, where the exact page-like count alongside it reads 106,588,412), and `author.joined_at` is an ISO DATE (`YYYY-MM-DD`), not an instant, because Facebook publishes page creation to the day. A **business page** carries considerably more than a personal profile, and all of it rides in `author.ext`: `business_category`, `website`, `links[]`, `public_phone`, `public_email`, `address`, `price_range`, `rating` (Facebook's recommendation string, e.g. `"74% recommend (9,493 reviews)"`) with `rating_count` (that review count as a number), `talking_about_count`, `cover_url`, `page_active`, and `ad_library_page_id` / `ad_library_status`: the Ad Library page id is a different id from `author.id` and is the one `/v1/facebook/adlibrary/company/ads` takes, so you can chain profile → ads off a single lookup. A personal profile returns null for the listing fields it has no equivalent for rather than omitting them. `links[]` and `business_hours[]` are also mapped, the latter only when you pass `get_business_hours=true`, but Facebook returned both empty on every page measured on 2026-08-11, so treat them as best effort rather than data you can depend on. `author.following` and `author.posts_count` remain null because the upstream profile response does not provide those totals.

TL;DR: `GET /v1/facebook/profile` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the Facebook page or profile. A profile share link (`https://www.facebook.com/share/…`) is accepted. |
| `get_business_hours` | no | Get the business's hours |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/facebook/profile" \
  --data-urlencode "url=https://www.facebook.com/Meta" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Facebook page data with an API?

Send a GET request to /v1/facebook/profile with the full Facebook page URL in the url parameter. SocialCrawl responds with JSON containing name, follower count, like count, category, about text, profile picture, and cover photo URL.

### What fields does GET /v1/facebook/profile return?

The response includes page name, vanity URL, follower count, like count, category, about description, profile picture URL, cover photo URL, verification status, and business hours (if requested via the get_business_hours parameter).

### Can I scrape Facebook profiles without a Graph API token?

Yes. SocialCrawl does not require a Graph API access token, app review, or Facebook login. Pass the page URL and your SocialCrawl x-api-key. The endpoint returns the public profile data directly.

### How much does the Facebook Profile API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, enough to pull around 100 Facebook pages before you pay anything.

### Can I get business hours for a Facebook page?

Yes. Pass get_business_hours=true as an optional parameter and the response will include the business's opening hours when Facebook exposes them on the page. Useful for local business directories and lead data.

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get Facebook page data with one API call
- What does the SocialCrawl Facebook Profile API return?