Facebook API endpoint
Fetches public data about a Facebook Page given its page ID, vanity name, or full page URL: name, follower/like counts, intro, category, business hours/price range, review count, and any public contact details (email, phone, address, website, WhatsApp number) exposed on the Page's About tab.
/facebook/{page}Path parameters:
page: required. A Facebook Page reference — vanity name (nike), handle
with a sub-path (nike/about), profile.php?id=..., pages//people//p//pg/
paths, or a full Facebook URL on any Facebook host (www.facebook.com,
m.facebook.com, fb.com, fb.me).A people/<name>/<id> path is a profile permalink rather than a Page vanity
URL, so it is resolved by its numeric id — people/Some-Biz/61556667234908
and profile.php?id=61556667234908 refer to the same Page and return the same
result. A people/<name> path carrying no numeric id cannot be resolved and
returns an invalid-parameter error.
Response behavior: the deeper contact fields (email, phones, address,
category, hours, priceRange, whatsapp) are populated when the Page
publishes them on its About tab; they are omitted when a Page doesn't expose
them. emails/phones are extracted independently and may contain more than
one value; email is the first extracted address, kept for backward
compatibility. pageId is Facebook's stable numeric identifier, which never
changes even if the Page renames its vanity handle.
| Field | In the sample | Value in the sample |
|---|---|---|
| title | Has a value | |
| og.title | Has a value | |
| og.description | Has a value | |
| og.image | Has a value | scontent-yyz1-1.xx.fbcdn.net |
| stats.likes | Has a value | 0 |
| stats.followers | Has a value | 0 |
| intro | Has a value | |
| Empty | ||
| address | Empty | |
| website | Empty | |
| company | Empty | |
| category | Has a value | |
| latestPostAt | Has a value | 0001-01-01 |
| reviewCount | Has a value | 0 |
| phones | Has a value | 1 entry |
| talking | Has a value | 162,987 |
| wereHere | Has a value | 18,491 |
| sourceUrl | Has a value | facebook.com |
| pageId | Has a value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| page (path) | string | Yes | Facebook Page reference: vanity name, handle, profile.php id, or full Facebook URL | nike | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/facebook/nike" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"title": "Woodland Windows",
"og": {
"title": "Woodland Windows",
"description": "Woodland Windows, Lisburn. 101 likes. Professional window cleaning service based in Lisburn.",
"image": "https://scontent.fna.fbcdn.net/v/t39.30808-1/..."
},
"stats": {
"likes": 101,
"followers": 0
},
"intro": "Professional window cleaning service based in Lisburn.",
"email": "woodlandwindowsinfo@gmail.com",
"address": "24 Woodland Avenue, Lisburn, United Kingdom, BT27 4PJ",
"category": "Home window service",
"reviewCount": 3,
"emails": [
"woodlandwindowsinfo@gmail.com"
],
"phones": [
"+44 7926 075025"
],
"sourceUrl": "https://www.facebook.com/woodlandwindows1/about",
"pageId": "100063628597424",
"hours": "Opening soon",
"priceRange": "Price range · £"
}
}Request schema
No body schema
Response schema
#/definitions/facebook.pageResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | facebook.Page | No | ||||
| data.address | string | No | 9985 Arthur Hills CT, Sacramento, CA, United States, California | |||
| data.category | string | No | Marketing Agency | |||
| data.company | string | No | Seo Marketing Wiz | |||
| data.email | string | No | contact@seomarketingwiz.com | |||
| data.emails | array | No | ["contact@seomarketingwiz.com"] | Fields populated by the Go-native browser-rendered extractor (parse.go). | ||
| data.hours | string | No | Open now | Hours is the About panel's business-hours summary text (e.g. "Open now", "Closes at 9 PM", "Opening soon"), when the Page publishes one. Not a structured weekly schedule. | ||
| data.intro | string | No | Marketing professionals with 20 years of experience wanting to provide digital marketing services to | |||
| data.latestPostAt | string | No | 2020-11-26T00:00:00.000Z | |||
| data.og | object | No | ||||
| data.og.description | string | No | SEO Marketing Wiz, Sacramento, California. 521 likes. Marketing professionals with 20 years of experience wanting to provide digital marketing services to | |||
| data.og.image | string | No | https://scontent-dfw5-2.xx.fbcdn.net/v/t39.30808-1/279690292_375554114584870_8657447943866659854_n.png?cstp=mx200x200&ctp=s200x200&_nc_cat=100&ccb=1-7&_nc_sid=3ab345&_nc_ohc=cJ5c41eGYbkQ7kNvwFpyUu7&_nc_oc=AdmE_uznxjhjbFVzL_VatcILSjMcv56Yft-_-icARncJRyR5i3CLrlh-9ZnkTHvyQWg&_nc_zt=24&_nc_ht=scontent-dfw5-2.xx&_nc_gid=JfTmimRDWsc3S1tfuZSW1A&oh=00_AfIjr4QtVdPoXb42NKwayq1Ud-aqW3G8YNoQ8Q9d2eDFEQ&oe=6827F32E | |||
| data.og.title | string | No | SEO Marketing Wiz | Sacramento CA | |||
| data.pageId | string | No | 100063763354867 | PageID is Facebook's stable numeric Page identifier -- unlike the vanity name/handle, it never changes even if the Page is renamed. | ||
| data.phones | array | No | ["+1 555 123 4567"] | |||
| data.priceRange | string | No | Price range · $$ | PriceRange is the About panel's price-tier text (e.g. "Price range · $$"), when the Page publishes one. | ||
| data.reviewCount | integer | No | 0 | |||
| data.sourceUrl | string | No | https://www.facebook.com/nike/about | |||
| data.stats | object | No | ||||
| data.stats.followers | integer | No | 526 | |||
| data.stats.likes | integer | No | 521 | |||
| data.talking | integer | No | 12 | |||
| data.title | string | No | SEO Marketing Wiz | |||
| data.website | string | No | http://www.seomarketingwiz.com/ | |||
| data.wereHere | integer | No | 3 | |||
| data.whatsapp | string | No | +1 800-242-8478 | WhatsApp is the Page's configured WhatsApp Business "Message us" number, when set up. See ParsePage's field_type extraction. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad request — missing or invalid page reference | #/definitions/app.Response |
| 404 | Page not found or unavailable | #/definitions/app.Response |
| 500 | Internal server error while fetching page data | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/facebook/nike" \
-H "x-api-key: $CRAWLORA_API_KEY"