How each product works
How to use Website Contacts Scraper
What Website Contacts Scraper takes in, which fields it returns and how credits are charged for each lookup.
What it does
Reads a domain's public pages and returns the email addresses, phone numbers and social profile links they publish.
What you send
Send these fields in the JSON body of the request.
No single field is required on its own, but a request with none of them is rejected: Provide url or domain.
| Field | Type | Required | Limits |
|---|---|---|---|
| url | string | Optional | up to 2,048 characters |
| domain | string | Optional | up to 253 characters |
| max_pages | integer | Optional | at least 1, at most 10 |
| country | string | Optional | fixed format |
Request fields for Website Contacts Scraper
What you get back
The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.
Each field is described in the API reference.
| Field | Type |
|---|---|
| emails | list |
| phones | list |
| social_profiles | list |
| pages_scanned | list |
| scanned_at | string |
Response fields for Website Contacts Scraper
What it costs
10 credits per domain with contacts found.
| Case | Charge |
|---|---|
| Found | 10 credits |
| Nothing found | 0 credits |
| Repeat inside 7 days | 0 credits |
| Errors and invalid requests | 0 credits |
What each outcome costs
Run it
You can try it without an account in the free tool. The free tools share a limit per visitor.
From code, send a POST request to https://YOUR_API_HOST/v1/website-contacts-scraper with your API key.
curl -X POST https://YOUR_API_HOST/v1/website-contacts-scraper \
-H "Authorization: Bearer $LOOKVALID_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"python.org","max_pages":5}'
A request to Website Contacts Scraper
Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.
Good to know
- A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
- When the lookup finds nothing it returns
found: falseand costs 0 credits. - Invalid input and errors are never charged.
- The API allows 200 requests per 10 seconds per key.
Related
Still stuck? Write to hello@lookvalid.com.