Scraping Products Instructions
Scraper API
Tools
Search

Search

Our Search API finds relevant domains based on search queries. Perfect for discovering content without knowing the exact domain.

What is Search?

Search allows you to find domains by searching for topics, products, or keywords. It returns relevant domains with titles that you can then scrape or map.

Discover domains — Find relevant websites without prior knowledge of their URLs.

How It Works

  1. Submit one or more search queries
  2. The API searches the web privately
  3. Returns matching domains and titles

Parameters Overview

Parameter Type Required Description
query string/array Yes Search query string(s) - single string or list of up to 10 queries
max_urls integer No Maximum URLs/domains to return (1-100). Default: 20
region string No Region for search results. Also determines proxy location. Default: ‘us-en’

Pricing

Search uses your 5 credits per query used. If max urls are reached you will be refunded for unused queries.

Quick Start

Search for domains related to a topic:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "e-commerce platforms",
    "max_urls": 10
  }'

Response:

{
  "success": true,
  "queries": ["e-commerce platforms"],
  "discovered_count": 10,
  "results": [
    {
      "domain": "www.shopify.com",
      "url": "https://www.shopify.com/blog/best-ecommerce-platforms",
      "title": "11 Best Ecommerce Platforms for Your Business in 2026",
      "query": "e-commerce platforms"
    },
    {
      "domain": "www.forbes.com",
      "url": "https://www.forbes.com/advisor/business/software/best-ecommerce-platform/",
      "title": "Best E-Commerce Platforms of 2026 - Forbes Advisor",
      "query": "e-commerce platforms"
    }
  ],
  "credits_used": 1.0,
  "credits_remaining": 9999.0
}

Multiple Queries

Search multiple topics in a single request:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": ["e-commerce platforms", "online store builders"],
    "max_urls": 20
  }'

Region-Specific Results

Get results tailored to a specific region. The region also determines the proxy location:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "news websites",
    "max_urls": 15,
    "region": "uk-en"
  }'

Available Regions

Region Code Description
us-en United States (English)
uk-en United Kingdom (English)
de-de Germany (German)
fr-fr France (French)
es-es Spain (Spanish)
it-it Italy (Italian)
jp-jp Japan (Japanese)
au-en Australia (English)

Response Fields

Field Description
domain The domain name of the discovered URL
url The full URL
title Page title from search results
query Which query matched this result

Common Use Cases

Competitor Discovery Find competitor websites by searching for your product category.

Lead Generation Discover potential leads by searching for industry-specific terms.

Market Research Find relevant websites and articles for research purposes.

Content Discovery Locate content sources for aggregation or analysis.

Async Mode

For large searches, use async mode:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "proxy services",
    "max_urls": 50,
    "async": true
  }'

Response (202 Accepted):

{
  "success": true,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "message": "Search task submitted for background processing",
  "check_url": "/api/v1/scraper/search/tasks/550e8400-e29b-41d4-a716-446655440000"
}

Check status:

curl "https://scrape.evomi.com/api/v1/scraper/search/tasks/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: YOUR_API_KEY"

Base URL 

https://scrape.evomi.com

All API requests use this base URL with the /api/v1/scraper/search endpoint.

Error Handling

Status Meaning
200 Success
202 Async task processing
400 Bad request
401 Unauthorized
402 Insufficient credits
404 Task not found
429 Rate limit exceeded

Next Steps

ℹ️
Search results are unique per domain - each domain appears only once even if multiple pages match.