Category
primaryCategory
Optional
The page's first self-declared category, e.g. 'Italian restaurant'.
Facebook Business Contact Extractor
Pricing
from $1.40 / 1,000 results
Pull public contact details from Facebook business pages at scale: email, phone, website, address, category, price range, services and followers. Feed it a list of pages, or discover them by keyword and country through the Ad Library, since Facebook's page search is closed to logged-out clients.
Input
_input
Optional
The page slug this record answers for.
Source
_source
Optional
Always page-about-tab.
Scraped at
_scrapedAt
Optional
UTC ISO 8601 timestamp when this record was emitted.
Record type
recordType
Optional
BUSINESS, RUN_SUMMARY or ERROR.
Error
_error
Optional
Failure rows only: page_not_found, fetch_failed or unexpected_error.
Error detail
_errorDetail
Optional
Why the page could not be read.
Slug
slug
Optional
The page's vanity slug.
Business name
pageName
Optional
Display name of the page.
Page URL
pageUrl
Optional
Canonical page URL.
Page ID
pageId
Optional
Numeric page id, decoded from the about section's node id.
Category
primaryCategory
Optional
The page's first self-declared category, e.g. 'Italian restaurant'.
All categories
categories
Optional
Every category the page lists.
Optional
First published email address. Null means the business publishes none - not that it was missed.
All emails
emails
Optional
Every email in the structured contact section.
Emails in the description
emailsFromDescription
Optional
Addresses found in the page's own description text rather than in the contact fields. Kept separate so a declared contact can be told apart from a scraped one.
Phone
phone
Optional
First published phone number, in the format the business entered it.
All phones
phones
Optional
Every phone number published.
Website
website
Optional
First published website, unwrapped from Facebook's l.facebook.com redirect.
All websites
websites
Optional
Every website published.
Address
address
Optional
First published street address.
All addresses
addresses
Optional
Every address published.
Open now?
hoursLabel
Optional
'Open now' or 'Closed now'. Facebook does not publish the weekly schedule to logged-out visitors, so this is a status at fetch time, not a set of opening hours.
Price range
priceRange
Optional
e.g. 'Price range · ££'.
Services
services
Optional
e.g. ['Delivery', 'Takeaway', 'Dine in'].
Followers
followers
Optional
Follower count. Facebook abbreviates large numbers, so this is approximate and the raw label is kept beside it.
Rating
ratingSummaryText
Optional
Facebook's own line, e.g. '94% recommend (1,236 reviews)'.
Recommend (%)
recommendPercent
Optional
Parsed from the rating line. Facebook retired star ratings for pages, so this is the rating.
Reviews
reviewCount
Optional
Total reviews the page has.
Has email
hasEmail
Optional
Whether the business publishes an email.
Has phone
hasPhone
Optional
Whether the business publishes a phone number.
Has website
hasWebsite
Optional
Whether the business publishes a website.
Has address
hasAddress
Optional
Whether the business publishes a street address.
Contact score
contactScore
Optional
How many of the four channels (email, phone, website, address) the business publishes, 0-4. It ranks a lead list; it does not claim to measure lead quality.
Discovered via
discoveredVia
Optional
'input' when you supplied the page, 'ad-library' when the actor found it by keyword.
Discovery query
discoveryQuery
Optional
The keyword and country that surfaced this page.
Page created
pageCreationDate
Optional
From the page transparency tab, when that option is on. Useful for telling an established business from a week-old one.
Currently advertising
isRunningAds
Optional
From the page transparency tab. A business already buying ads is a different kind of lead from one that is not.
Ad status (as shown)
adStatusText
Optional
Facebook's own sentence about the page's advertising.
Social handles
socialHandles
Optional
Other-network usernames the page lists.