Local Business Enrichment Tool API

Match a list of businesses against the Local Business Database and append phone, website, emails, address, category, rating, reviews and the contact person. Match keys (priority order): phone, business name with a city or postal code, website. A website alone returns one location of that business. Requires $649/mo plan.

Included with $649/mo planGET /api/v1/enrich/local-businesses

Database APIs are included with the $149/mo plan.

Parameters

Name	Type	Required	Description
`rows`	object[]	Required	Array of input rows. Each row needs at least one of: phone, name with city or postal_code, website. Optional per row: state (picks between places with the same name) and country (ISO code or name, for phones and addresses outside the US and Canada). Up to 1,000 rows per request.Example: [{"phone":"+1 512-555-0100"},{"name":"Smile Dental","city":"Austin","state":"TX"},{"website":"smiledental.com"}]
`preview`	boolean	Optional	If true, returns match count + sample without counting toward your daily allowance.Default: falseExample: false

Examples

Enrich a list of business phone numbers

curl -X POST "https://app.scrapercity.com/api/v1/enrich/local-businesses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"phone":"+1 512-555-0100"},{"phone":"+1 214-555-0199"}]}'

Enrich a mixed list (phone + name and city + website)

curl -X POST "https://app.scrapercity.com/api/v1/enrich/local-businesses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"phone":"+1 512-555-0100"},{"name":"Smile Dental","city":"Austin","state":"TX"},{"website":"smiledental.com"}]}'

Preview match count without consuming daily allowance

curl -X POST "https://app.scrapercity.com/api/v1/enrich/local-businesses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows":[{"phone":"+1 512-555-0100"}],"preview":true}'

Use Cases

•Fill in phone, website and emails for a list of businesses before outreach
•Add ratings, reviews and the contact person to a CRM export of local businesses
•Look up a business from its phone number

Best Practices

•Provide a phone and a business name with its city or postal code when you have them: phone is the most exact match
•Use preview mode (preview: true) to estimate match rate before processing large lists
•Rate limit: 1,000 rows per request, 100,000 matches per day
•Daily limit resets at midnight UTC
•Website-only rows return one location of that business (chains share a website)
•A phone without a country is tried as a US and a Canadian number. Send country for other countries
•Requires $649/mo plan

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.

Local Business Enrichment Tool API API Documentation