Facebook Page Contacts
Get the public contact details of Facebook business pages: page name, category, email, phone, website, address, followers, likes, rating and price range. Send a list of page links (up to 5,000 a run), or search Facebook pages by keyword and place (up to 500 pages a search). Pages that are gone or hidden on Facebook come back marked not_available and are not charged.
$0.0012 per page from page links, $0.0028 per page from a search
POST /api/v1/scrape/facebook-pagesParameters
| Name | Type | Required | Description |
|---|---|---|---|
pages | string[] | Optional | Facebook page links or page names, up to 5,000 a run. Accepts facebook.com/name, profile.php?id= links, /people/ and /p/ links and m. or web. links. Use pages, or keyword and location.Example: ["https://www.facebook.com/TwoMaidsFranchise", "kighthomecenterbuilding"] |
keyword | string | Optional | Search: what the business does, as people would type it on Facebook (used with location)Example: roofing contractor |
location | string | Optional | Search: the city or area, with its state or countryExample: Englewood, New Jersey |
maxResults | number | Optional | Search: the most pages to return (default 100, up to 500)Default: 100Example: 100 |
Examples
Contacts from a list of Facebook pages
curl -X POST https://app.scrapercity.com/api/v1/scrape/facebook-pages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pages": ["https://www.facebook.com/TwoMaidsFranchise", "https://www.facebook.com/kighthomecenterbuilding"]
}'Find roofing contractors on Facebook in a city
curl -X POST https://app.scrapercity.com/api/v1/scrape/facebook-pages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "roofing contractor",
"location": "Englewood, New Jersey",
"maxResults": 100
}'Check status and download
curl -X GET https://app.scrapercity.com/api/v1/scrape/status/{runId} \
-H "Authorization: Bearer YOUR_API_KEY"
# When status is SUCCEEDED, download the CSV
curl -L https://app.scrapercity.com/api/downloads/{runId} -o facebook-pages.csvUse Cases
- •Emails for local businesses that list one only on their Facebook page
- •Contact details for the Facebook links a Google Maps or Yelp scrape returns
- •Lists of local service businesses (contractors, salons, restaurants) by city, with email and phone
- •Follower counts and ratings to rank a list of businesses by how active they are
Best Practices
- •Charged per page found; links to pages that are gone or hidden, and links that are not pages (groups, posts), cost nothing
- •Page links read at about 3 pages a second: 1,000 pages take about 5 minutes. A search takes 1 to 5 minutes
- •About 1 in 5 Facebook links from older listings point to pages that are gone or hidden. Of the pages found, about 3 in 4 list an email and 9 in 10 a phone
- •A search with few results has a minimum charge
- •CSV columns: input, status, page_name, category, email, phone, website, address, followers, likes, rating, price_range, facebook_url, page_id
Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.
Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.