Search

POST1 Credit

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

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

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": 10,
    "results": [
      {
        "position": 1,
        "title": "Example result",
        "url": "https://example.com/result",
        "snippet": "A structured search result."
      }
    ],
    "pagination": {
      "nextCursor": null,
      "hasMore": false
    },
    "creditsUsed": 1
  }
}