Spotted something off?Report on Discord
api reference

request.post

Send a POST request through a real browser session with a form-encoded or JSON body.

Updated Sep 8, 2025

Sends a POST request using a real browser session, with all the power of request.get plus support for sending request bodies.

Parameters

This endpoint accepts all the same parameters as request.get, with one key additional parameter:

Parameter Type Required Description
postData string Yes The body of the POST request. Must be a string in application/x-www-form-urlencoded format. Example: a=b&c=d. To send JSON data, set the appropriate content type using customHeaders: "customHeaders": { "content-type": "application/json" }

Shared Parameters

Refer to request.get for detailed descriptions of shared parameters like:

  • session
  • cookies / cookiejar
  • proxy / proxyCountry
  • customHeaders
  • includeImages
  • includeLinks
  • requestType
  • localStorage

Request

Send a Form-Encoded Body

The default. Pass postData as an application/x-www-form-urlencoded string:

json5 lines

Send a JSON Body

To send JSON, pass postData as an object and set the content-type header:

json10 lines

Response

json50 lines