ScraperCity logo

Facebook Page Contacts API Documentation

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 searchPOST /api/v1/scrape/facebook-pages

Parameters

NameTypeRequiredDescription
pagesstring[]OptionalFacebook 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"]
keywordstringOptionalSearch: what the business does, as people would type it on Facebook (used with location)Example: roofing contractor
locationstringOptionalSearch: the city or area, with its state or countryExample: Englewood, New Jersey
maxResultsnumberOptionalSearch: 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.csv

Use 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.