Search the web

Runs a web search for query and returns ranked organic results with contiguous position values from 1.

Use limit (1–100, default 10) to request more results in a single call. Results are fetched in pages of 10, so a call consumes ceil(limit / 10) credits (capped at 10) from the account's monthly credits bucket — for example limit=10 costs 1 credit and limit=35 costs 4. Credits are charged for every page fetched regardless of how many results a page returns. The credit count is reported as credits_used in the response.

Authorization

AuthorizationRequiredBearer <token>

API key. Manage keys from the dashboard at app.bytekit.com.

In: header

Request Body

application/jsonRequired

queryRequiredstring

The search query, up to 2048 characters.

Minimum length: 1Maximum length: 2048

typestring

Which search index to query. web (default) returns ranked organic results; news returns news articles in the same results array, additionally populating source and image on each item; images returns image results, populating source, domain, and a fuller image object (full-image dimensions plus a thumbnail URL and dimensions) while omitting snippet and date. Billing is identical for all three.

Default: "web"Value in: "web" | "news" | "images"

limitinteger

Maximum number of organic results to return. Results are fetched in pages of 10, so the call costs ceil(limit / 10) credits (capped at 10).

Default: 10Minimum: 1Maximum: 100

countrystring

Two-letter country code to localize results (e.g. us, de), normalized to lowercase. Defaults to us.

Default: "us"

languagestring

Two-letter ISO-639-1 language code for results (e.g. en, fr), normalized to lowercase. Defaults to en.

Default: "en"

date_rangestring

Restrict results to a recency window: any (default, no time filter), hour (past hour), day (past 24 hours), week (past week), month (past month), or year (past year). Applies identically to every type; billing is unchanged.

curl -X POST https://api.bytekit.com/v1/search \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best web scraping tools",
  "limit": 20,
  "country": "us",
  "language": "en",
  "date_range": "week"
}'

Search completed.

{
  "id": "sr_01HX9Z8K7Q2W3E4R5T6Y7U8I9O",
  "query": "best web scraping tools",
  "results": [
    {
      "position": 1,
      "title": "Example Result",
      "url": "https://example.com/article",
      "snippet": "A short description of the result.",
      "date": "2026-01-15"
    }
  ],
  "related_searches": [
    "web scraping tools open source",
    "best web scraping api"
  ],
  "credits_used": 2
}

Search the web

Authorization

Request Body

Response