ScraperCity logo

Website Contact Scraper API Documentation

Website Contact Scraper

Get the emails, phone numbers and social profiles each business prints on its own website. Give a list of websites or domains; each site's home page and its contact, team and about pages are read (found from the sitemap and the home page's links, following robots.txt), and every email comes back with the person's name when the site prints it next to a matching email, and with its email check result (valid, valid_catch_all, invalid or unknown). One row per website. Use it on the websites from a Google Maps or Store Leads run to reach businesses with no email in the listing.

$0.0040 per website with an email or phone foundPOST /api/v1/scrape/website-contacts

Parameters

NameTypeRequiredDescription
websitesstring[]RequiredWebsites or domains, one per item (up to 10,000 a search). Full URLs are fine; each domain is read once.Example: ["acme.com", "https://www.example.org/contact"]

Examples

Emails and phones from a list of websites

curl -X POST https://app.scrapercity.com/api/v1/scrape/website-contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "websites": ["acme.com", "https://www.example.org/contact", "bakery.co.uk"]
  }'

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 website-contacts.csv

Use Cases

  • •Emails for the businesses from a Google Maps or Store Leads run that came without one
  • •The owner's or front desk's own address for local businesses, agencies and shops, as printed on their site
  • •Phone numbers and LinkedIn, Facebook and Instagram pages for a list of company websites

Best Practices

  • •Charged per website that comes back with at least one email or phone; a website with none, one that could not be read, or a social network or directory link is listed in the file and costs nothing
  • •On 80 real business websites, 84% came back with an email or phone and 70% with an email, reading 3.6 pages a site
  • •A list of about 1,000 websites took about 10 minutes, email checks included
  • •Up to 5 emails per website in their own columns (emails at the site's own domain first), the rest in more_emails; email statuses are valid, valid_catch_all (the domain accepts every address), invalid and unknown
  • •For one named person by job title at each company (the CEO, the head of sales), use the Domain Email Finder instead
  • •CSV columns: website, domain, status, email_1, email_1_name, email_1_status (to email_5), more_emails, phone_1 to phone_3, more_phones, linkedin, facebook, instagram, twitter, youtube, tiktok, pages_read, note

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.