API ReferenceFetch

Fetch a URL (GET)

Direct HTTP fetch. The response body IS the content; metadata is returned in X-Fetch-* headers. Omit `format` for raw passthrough. Use `format=markdown` or `format=html` for conversion.

GET
/v1/fetch

Authorization

AuthorizationRequiredBearer <token>

API key. Obtain from POST /v1/account/api-keys.

In: header

Query Parameters

urlRequiredstring
Format: "uri"
formatstring
Value in: "markdown" | "html"
countrystring
Default: "US"Pattern: "^[A-Z]{2}$"
timeout_msinteger
Default: 60000Minimum: 1000Maximum: 60000
cache_ttlstring | integer

How long a freshly fetched URL may be served from cache. 0 disables caching. Accepts Nh (hours, up to 168h), Nd (days, up to 7d), or the integer 0. Examples: 0, 48h, 2d. Invalid values receive a 422 validation_error with an actionable message.

Default: "48h"
curl -X GET "https://api.bytekit.com/v1/fetch?url=http%3A%2F%2Fexample.com&format=markdown&country=US&cache_ttl=48h" \
  -H "Authorization: Bearer <token>"

Content from upstream.

"string"

Get scrape bulk job status

Previous Page

Fetch a URL (POST)

Same as GET /v1/fetch but with a JSON request body.