1-2 pages; 1 record when it falls back. A failed run costs 0. The same input within 1 h costs 0.

facebook-profile

Q: How do I get Facebook data through an API?

Call POST /recipes/facebook-profile with your key and profile. You get rows with the 24 fields above. The recipe is tested against the live site every 6 hours.

Q: Can I try it without paying?

Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.

Q: What if the site changes?

The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.

One public Facebook profile or page as one row: name, ids, category, intro, followers, contact lines (website, e-mail, phone, address), rating, place, photos, verified badge. profile is the name after facebook.com/, a profile.php?id= number, or the URL. About 5-25 s; when the page fails, a slower second source answers (2-4 min). session (optional) = your c_user and xs cookies; the page is then read as you see it. You supply your own session. Crawl4AI uses it for this run only and does not store it. Your account and the site's terms are your responsibility.

stagedfacebook.comWASM module24 fields1-2 pages; 1 record when it falls backfresh 1 h

Run it below API reference

‹ Recipes

…json

POST api.crawl4ai.com/recipes/…

$ crawl recipe

Live · your key · counts against your quota✓ 200 OK

# Hit Run - the rows render here as a table, with the cost

Fields

24 columns on every row. null means the site does not state it.

field	type	meaning
profile_id	string	Facebook's id of the profile (digits, as a string).
page_id	string	The id of the Facebook Page behind the profile (a page, or a person in professional mode); null for a plain personal profile, and on the second source for a person.
username	string	The name after facebook.com/ ("NASA"); null when the profile has none (a profile.php?id= address).
url	string	The profile's address on facebook.com.
name	string	The name the profile shows.
type	string	"page" for a Facebook Page, "profile" for a person's profile.
category	string	Facebook's category for it ("Government organization", "Public figure", "Deli"); null when none is shown.
intro	string	The short bio at the top of the intro card.
details	string[]	The other intro lines as Facebook writes them ("Founder and CEO at Meta", "From Dobbs Ferry, New York", "NIKE, Inc. is responsible for this Page"), in page order.
followers	integer	How many people follow it; exact on our page, rounded by the second source.
following	integer	How many profiles it follows, as the header shows it ("52", "1.2K" read as 1200); null on the second source.
talking_about	integer	How many people talk about it, as Facebook counts them; null on the second source.
checkins	integer	How many people checked in there ("were here"); null when the page has no place, and on the second source.
address	string	The street address of a business page; null when none is shown.
phone	string	The phone number on the intro card; null when none is shown.
email	string	The e-mail address on the intro card; null when none is shown.
websites	string[]	The website and social links on the intro card, the real address (not Facebook's redirect link).
price_range	string	A business page's price range ("$$"); null when none is shown.
recommend_percent	integer	The share of reviewers who recommend the business (98 for 98%); null without reviews.
review_count	integer	How many reviews that share counts; null without reviews.
location		Where the person lives ("Palo Alto, California"), from the "Lives in" line; null for a page.
profile_photo	string	The profile picture URL; signed by Facebook, it stops working after some days.
cover_photo	string	The cover image URL; signed by Facebook, it stops working after some days; null when there is none.
is_verified	boolean	true when Facebook shows the verified badge.

null means the site does not state it.

profile_idstringFacebook's id of the profile (digits, as a string).

page_idstringThe id of the Facebook Page behind the profile (a page, or a person in professional mode); null for a plain personal profile, and on the second source for a person.

usernamestringThe name after facebook.com/ ("NASA"); null when the profile has none (a profile.php?id= address).

urlstringThe profile's address on facebook.com.

namestringThe name the profile shows.

typestring"page" for a Facebook Page, "profile" for a person's profile.

categorystringFacebook's category for it ("Government organization", "Public figure", "Deli"); null when none is shown.

introstringThe short bio at the top of the intro card.

detailsstring[]The other intro lines as Facebook writes them ("Founder and CEO at Meta", "From Dobbs Ferry, New York", "NIKE, Inc. is responsible for this Page"), in page order.

followersintegerHow many people follow it; exact on our page, rounded by the second source.

followingintegerHow many profiles it follows, as the header shows it ("52", "1.2K" read as 1200); null on the second source.

talking_aboutintegerHow many people talk about it, as Facebook counts them; null on the second source.

checkinsintegerHow many people checked in there ("were here"); null when the page has no place, and on the second source.

addressstringThe street address of a business page; null when none is shown.

phonestringThe phone number on the intro card; null when none is shown.

emailstringThe e-mail address on the intro card; null when none is shown.

websitesstring[]The website and social links on the intro card, the real address (not Facebook's redirect link).

price_rangestringA business page's price range ("$$"); null when none is shown.

recommend_percentintegerThe share of reviewers who recommend the business (98 for 98%); null without reviews.

review_countintegerHow many reviews that share counts; null without reviews.

locationWhere the person lives ("Palo Alto, California"), from the "Lives in" line; null for a page.

profile_photostringThe profile picture URL; signed by Facebook, it stops working after some days.

cover_photostringThe cover image URL; signed by Facebook, it stops working after some days; null when there is none.

is_verifiedbooleantrue when Facebook shows the verified badge.

How it behaves

Cost. 1-2 pages; 1 record when it falls back. A failed run costs 0.

Freshness 1 h. The same input within 1 h is served from cache at 0 units.

How it answers. Answers at once for one input; a large run goes as a job you poll.

Questions about this recipeQuestions

Short answers. The API reference has the long ones.

How do I get Facebook data through an API?

Call POST /recipes/facebook-profile with your key and profile. You get rows with the 24 fields above. The recipe is tested against the live site every 6 hours.

What does it cost?

Can I try it without paying?

What if the site changes?

Need more from Facebook?

Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.

Request a change

More for social listening

All 24 recipes →

telegram-channelTelegram

verified

The latest messages of a public Telegram channel, from its web preview page: text, time, view count, the message's link and id, newest…

Social listening5 fields

2 units · fresh 5 minTry it →

facebook-page-postsFacebook

staged

A public Facebook page's posts as its first load carries them (no paging): one row per post with id, URL, text (first 1000 chars), time…

Social listening9 fields

2 units · fresh 10 minTry it →

facebook-postFacebook

staged

One public Facebook post as one row: id, URL, author, text, time posted, reactions in total and by type, comments, shares, photos and…

Social listening14 fields

1-2 pages; 1 record when it falls back · fresh 30 minTry it →

For developers

Get a free API key and run your first crawl.

1,000 credits every month. No credit card. Your self-hosted setup keeps working.

Get a free API key

For teams

Talk to us about volume, regions and an SLA.

A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.

Book a call hello@crawl4ai.com