DomainScope Domain Finder — Apify Actor

Find company domains by industry, city, and/or country using DomainScope's categorized-domain corpus. Wraps POST /api/v1/domains/search, which is public — no DomainScope account or API key required.

Unlike search-engine-scraping approaches (which have to iterate every profession × city combination as a separate query), DomainScope's filter engine accepts industries/cities/countries as native arrays with an any (OR) or all (AND, default) match mode, so one call covers the whole combination — "Technology" + "San Francisco" returns Technology companies that are in San Francisco, not either independently.

Input

See .actor/input_schema.json:

• industries, cities, countries — lists to filter on. At least one of these (or searchQuery) is required. See the DomainScope API's GET /industries, /cities, /countries for the full vocabulary each accepts.
• searchQuery — optional free-text filter, combined with the others.
• matchMode — "all" (AND, default) or "any" (OR).
• maxResults — how many domains to fetch (default 200).

Output

One dataset row per matching domain, shaped like model.CategoryResult: url, category, sub_category, industry, country, city, business_model, target_market, audience_profile, content_focus, entity_type, summary.

The 1,000-record preview cap

DomainScope's search preview refuses any page beyond record 1000 (offset > 1000 → limit_exceeded, "Search preview is limited to 1000 records. Please use the Export feature for bulk data retrieval."). This Actor pages in batches of 100 (the API's own per-page ceiling) until either maxResults is reached, the 1000-record cap is hit, or results run out. For volumes beyond that, use DomainScope's own Export feature (GET /export/snapshot) directly against the API.

Billing

Charges one domain-returned event (via Actor.charge()) per domain delivered to the dataset, priced at $3.00 / 1,000 domains on Apify Store. Actor.charge() is a documented no-op outside a pay-per-event-enabled run, so local development and apify run work without any billing setup.

Local development

npm install
echo '{"industries": ["Technology"], "cities": ["San Francisco"], "maxResults": 20}' \
  > storage/key_value_stores/default/INPUT.json
npm run start:dev

Or: apify run --input '{"industries": ["Technology"], "cities": ["San Francisco"]}'

Deploying

apify login
apify push