Search

POST1 credit / 10 results

https://api.crawlkit.sh/search

Search the public web and return structured DuckDuckGo results with region, recency and cursor controls.

Try on Playground

Authentication

Send your Crawlkit API key directly in the Authorization header.

Authorization: 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.timeRange`	string	Recency filter.
`options.maxResults`	number	Maximum result count.

Example Request

Use direct HTTP requests against the public API base URL.

Example request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17const response = await fetch('https://api.crawlkit.sh/search', {
  method: 'POST',
  headers: {
    Authorization: 'ck_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "query": "web research APIs",
    "options": {
      "region": "us-en",
      "timeRange": "m",
      "maxResults": 10
    }
  })
});

console.log(await response.json());

Response

This example returns one result and uses 1 credit. 1 credit per 10 returned results, rounded up. Empty results cost 0 credits. Unused reservations are refunded.

Success response (200 OK)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21{
  "success": true,
  "requestId": "example-request-id",
  "data": {
    "query": "web research APIs",
    "totalResults": 1,
    "results": [
      {
        "position": 1,
        "title": "Example result",
        "url": "https://example.com/result",
        "snippet": "A structured search result."
      }
    ],
    "pagination": {
      "nextCursor": null,
      "hasMore": false
    },
    "creditsUsed": 1
  }
}