Web Search

POST1 Credit

https://api.crawlkit.sh/v1/crawl/search

Perform web searches via DuckDuckGo and get structured results. Perfect for SEO monitoring, market research, and content discovery. Pay per page of results.

Try on Playground

Authentication

Send your Crawlkit API key as a Bearer token in the Authorization header.

Authorization: Bearer ck_your_api_key

Request Parameters

Send these JSON body fields in your request payload.

Name	Type	Description
`query`	string	Search query text.
`options.region`	string	Region code.
`options.maxResults`	number	Maximum result count.
`options.timeRange`	string	Recency filter.

Example Request

Use direct HTTP requests against the public API base URL.

Example request

1const response = await fetch('https://api.crawlkit.sh/v1/crawl/search', {2  method: 'POST',3  headers: {4    'Authorization': 'Bearer YOUR_API_KEY',5    'Content-Type': 'application/json'6  },7  body: JSON.stringify({8    query: 'best web scraping api',9    options: {10      region: 'us-en',11      maxResults: 20,12      timeRange: 'm'13    }14  })15});16 17const { data } = await response.json();18data.results.forEach(r => console.log(r.title, r.url));

Response

Success (200 OK): Returns service-specific structured payload.

Success response (200 OK)

1{2  "success": true,3  "data": {4    "query": "best web scraping api",5    "totalResults": 15,6    "results": [7      {8        "position": 1,9        "title": "Best Web Scraping APIs in 2024",10        "url": "https://example.com/article",11        "snippet": "Compare the top web scraping..."12      }13    ],14    "timing": { "total": 1250 },15    "creditsUsed": 1,16    "creditsRemaining": 9817  }18}