# Search

Source: https://docs.evomi.com/scraping-products-instructions/scraper-api/tools/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' |
| `webhook` | object | No |  [Webhooks](/scraping-products-instructions/scraper-api/webhooks/) configuration for real-time notifications |

## 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:

```bash
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:**
```json
{
  "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:

```bash
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:

```bash
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:

```bash
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):**
```json
{
  "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:**
```bash
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

- **[Usage Examples](/scraping-products-instructions/scraper-api/tools/search/usage-examples/)** - More detailed examples
- Found your Domain? Use  **[Url Discovery](/scraping-products-instructions/scraper-api/tools/url-discovery/)** to discover urls from the domain and **[Scraper API](/scraping-products-instructions/scraper-api/)** to scrape them

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

## Pages in this section

- [Search Tool Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/tools/search/usage-examples/index.md): Search API requests and responses: single and multiple queries, regional results, async handling, and passing the domains you find straight into a scrape.