Skip to content

Structured Utilities data: send queries and location. Cursor-paginated, 2 credits per successful call.

GET · POST2 credits / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/industry-email/Open in Playground

Call GET /api/v2/industry-email/ with queries and location. The results are in data.places; send data.next_cursor back as cursor to get the next page. 14 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/industry-email/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "queries=dentist" \
--data-urlencode "location=Houston, TX" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
queriesstringyese.g. dentistBusiness type / search term. Required first call.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
locationstringyese.g. Houston, TXPlace name or "lat,lng". Required first call.
locked in cursor
scrape_leadsbooleannotrueCrawl websites for leads.
locked in cursor
fetch_review_countbooleannotrueFill total_reviews.
locked in cursor
max_pages_per_siteintegerno4Website pages per business.
locked in cursor
only_with_websitebooleannofalse
locked in cursor
only_with_emailbooleannofalse
locked in cursor
min_ratingstringno—
locked in cursor
min_reviewsintegerno—
locked in cursor
tag_filterstringno—Comma-separated category words.
locked in cursor
in_area_onlybooleannofalse
locked in cursor
languagestringnoen
locked in cursor
include_all_emailsbooleannofalse
locked in cursor
include_all_phonesbooleannofalse
locked in cursor
include_crawl_infobooleannofalse
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"query": "dentist",
"location": "Houston, TX",
"page": 1,
"page_size": 10,
"places": [
{
"name": "Dentiq Dentistry Houston",
"place_id": "ChIJ_Ru-FaHAQIYRByxtRN6K3Ck",
"street_address": "1355 W Gray St",
"city": "Houston",
"zip": "77019",
"state": "Texas",
"country_code": "US",
"full_address": "1355 W Gray St Houston Texas 77019 US",
"lat": 29.7528037,
"long": -95.3976492,
"website": "https://www.dentiq.dental/",
"avg_rating": 4.9,
"total_reviews": 1312,
"tags": [
"Dentist",
"Cosmetic dentist",
"Teeth whitening service"
],
"lead": {
"website": "https://www.dentiq.dental/",
"title": "Top-Rated Houston Dentist | Dentiq Dentistry",
"phone": "(713) 526-2904",
"email": "[email protected]",
"social_media": {
"facebook": "https://www.facebook.com/dentiqdentistry",
"instagram": "https://www.instagram.com/dentiqdentistry",
"twitter": null,
"linkedin": null,
"youtube": "https://www.youtube.com/channel/UCd4c-mFQaBZ4cJGhYS8GEuA",
"pinterest": null,
"tiktok": "https://www.tiktok.com/@dentiqhtx",
"snapchat": null,
"reddit": null,
"tumblr": null
}
},
"keyword": "dentist",
"location": "Houston, TX",
"scraped_at": "2026-10-03T07:14:08.716Z"
}
],
"next_cursor": "eyJsayI6eyJsb2NhdGlvbiI6IkhvdXN0b24sIFRYIn0sInAiOjIsInEiOiJkZW50aXN0IiwicyI6WyJDaElKX1J1LUZhSEFRSVlSQnl4dFJONkszQ2siXX0"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.places.

FieldTypeExampleDescription
querystringdentist—
locationstringHouston, TX—
pageinteger1—
page_sizeinteger10—
placesarray[1 item]The results.
next_cursorstringeyJsayI6eyJsb2NhdGlvbiI6IkhvdXN0b24sIFRYIn0sI…Pass back as cursor for the next page. null on the last page.
places[].namestringDentiq Dentistry Houston—
places[].place_idstringChIJ_Ru-FaHAQIYRByxtRN6K3Ck—
places[].street_addressstring1355 W Gray St—
places[].citystringHouston—
places[].zipstring77019—
places[].statestringTexas—
places[].country_codestringUS—
places[].full_addressstring1355 W Gray St Houston Texas 77019 US—
places[].latnumber29.7528037—
places[].longnumber-95.3976492—
places[].websitestringhttps://www.dentiq.dental/—
places[].avg_ratingnumber4.9—
places[].total_reviewsinteger1312—
places[].tagsarray[3 items]—
places[].leadobject{…}—
places[].keywordstringdentist—
places[].locationstringHouston, TX—
places[].scraped_atstring2026-10-03T07:14:08.716Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/industry-email/";
let params = { queries: "dentist", location: "Houston, TX" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.places ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Locked into the cursor: location, scrape_leads, fetch_review_count, max_pages_per_site, only_with_website, only_with_email, min_rating, min_reviews, tag_filter, in_area_only, language, include_all_emails, include_all_phones, include_crawl_info. Set them on the first call; later pages reuse them.