Spotted something off?Report on Discord
api reference
Making Requests
Send requests through Scrappey by POSTing a URL and optional headers, cookies, or proxy to the API endpoint.
Updated Jan 18, 2026
Send a POST request to the Scrappey API with a URL, optional headers, cookies, and proxy, and the platform manages browser execution, rendering, session state, and response collection automatically.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cmd |
string | Yes | The command to execute, e.g. request.get, request.post, or one of the other request commands. |
url |
string | Yes | The target URL to request. |
headers |
object | No | Custom request headers to send. |
cookies |
array | No | Cookies to include with the request. |
proxy |
string | No | Proxy to route the request through. |
Request
Authenticate by including your API key in the query string. Send the command and target URL as a JSON body.
javascript13 lines
Response
A successful response returns solution.verified: true along with the page content, cookies, headers, and IP info.
json65 lines
Error Response
An error returns a status code 200 with solution.verified set to false. This request is not charged. The response always includes "data": "error" and an "error" field explaining the failure reason.
json10 lines