Browser

Coming soon. Mint a single-use connect URL for /v1/browser

Coming soon. Returns a /v1/browser URL that carries a short-lived token instead of the API key, for CDP clients that accept only a URL. The key goes in the Authorization header of THIS request only (a query key is refused). The token is single-use, expires after 60 s, and is bound to the options in the body: connect with the URL unchanged. path is authoritative: the URL relative to the API base. url is built from the deployment's SPICRAWL_BROWSER_PUBLIC_URL when set, otherwise from this request's scheme and Host header (caller-controlled, a convenience only). The token is never logged and never stored in plaintext. Requires the browser scope.

post/v1/browser/token

Request

  • Base URL: https://api.spicrawl.com
  • URL: https://api.spicrawl.com/v1/browser/token
  • Auth: HTTP bearer

Request body

engine'browser' | 'js'
proxy_countrystring
proxy_regionstring
sticky_keystring
session_ttlinteger
headlessboolean

Response

The connect URL, sent with Cache-Control no-store.

urlstring required
pathstring required
expires_atstring date-time required
expires_ininteger required
single_useboolean required

Example response

{
  "url": "wss://api.spicrawl.com/v1/browser?proxy_country=de&token=wbt_Q2hhbmdlTWVJbkEtVGVzdC1Ub2tlbi1FeGFtcGxlLVZhbHVlMDE",
  "expires_in": 60
}

Changes

No recorded changes to this operation across all 1 revision of this API.