request.post
api reference7 sections
request.post – Documentation
📡 Sends a
POSTrequest using a real browser session, with all the power and flexibility ofrequest.get, plus support for sending request bodies.
🔧 Parameters
This endpoint accepts all the same parameters as request.get, with one key additional parameter:
| Parameter | Required | Description |
|---|---|---|
postData |
✅ 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" } |
✅ For Everything Else
Refer to request.get for detailed descriptions of shared parameters like:
sessioncookies/cookiejarproxy/proxyCountrycustomHeadersincludeImagesincludeLinksrequestTypelocalStorage
Request Format
json5 lines
{
"cmd": "request.post",
"url": "https://httpbin.rs/post",
"postData": "a=b"
}Request Format JSON
json10 lines
1{
2 "cmd": "request.post",
3 "url": "https://httpbin.org/post",
4 "postData": {
5 "a": "b"
6 },
7 "customHeaders": {
8 "content-type": "application/json"
9 }
10}Response Format
json50 lines
1{
2 "solution": {
3 "verified": true,
4 "currentUrl": "https://httpbin.rs/post",
5 "statusCode": 200,
6 "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0",
7 "innerText": "{\"body_string\":\"a=b\",\"headers\":{\"accept\":\"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\"accept-encoding\":\"gzip, br\",\"accept-language\":\"en-US,en;q=0.5\",\"cache-control\":\"no-cache\",\"cdn-loop\":\"cloudflare; loops=1\",\"cf-connecting-ip\":\"223.181.110.217\",\"cf-ipcountry\":\"IN\",\"cf-ray\":\"947fc6437bdfe237-MRS\",\"cf-visitor\":\"{\\\"scheme\\\":\\\"https\\\"}\",\"content-length\":\"3\",\"content-type\":\"application/x-www-form-urlencoded\",\"host\":\"httpbin.rs\",\"origin\":\"https://httpbin.rs\",\"pragma\":\"no-cache\",\"priority\":\"u=0, i\",\"referer\":\"https://httpbin.rs/\",\"sec-fetch-dest\":\"document\",\"sec-fetch-mode\":\"navigate\",\"sec-fetch-site\":\"same-origin\",\"sec-fetch-user\":\"?1\",\"upgrade-insecure-requests\":\"1\",\"user-agent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0\",\"x-forwarded-for\":\"223.181.110.217, 172.70.108.70\",\"x-forwarded-host\":\"httpbin.rs\",\"x-forwarded-port\":\"80\",\"x-forwarded-proto\":\"https\",\"x-forwarded-server\":\"ab65c85a31ae\",\"x-is-trusted\":\"yes\",\"x-real-ip\":\"223.181.110.217\"},\"json\":null,\"method\":\"POST\",\"origin\":\"223.181.110.217\",\"query\":null,\"uri\":\"/post\"}",
8 "cookies": [],
9 "cookieString": "",
10 "response": "<html><head><link rel=\"stylesheet\" href=\"resource://content-accessible/plaintext.css\"></head><body><pre>{\"body_string\":\"a=b\",\"headers\":{\"accept\":\"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\"accept-encoding\":\"gzip, br\",\"accept-language\":\"en-US,en;q=0.5\",\"cache-control\":\"no-cache\",\"cdn-loop\":\"cloudflare; loops=1\",\"cf-connecting-ip\":\"223.181.110.217\",\"cf-ipcountry\":\"IN\",\"cf-ray\":\"947fc6437bdfe237-MRS\",\"cf-visitor\":\"{\\\"scheme\\\":\\\"https\\\"}\",\"content-length\":\"3\",\"content-type\":\"application/x-www-form-urlencoded\",\"host\":\"httpbin.rs\",\"origin\":\"https://httpbin.rs\",\"pragma\":\"no-cache\",\"priority\":\"u=0, i\",\"referer\":\"https://httpbin.rs/\",\"sec-fetch-dest\":\"document\",\"sec-fetch-mode\":\"navigate\",\"sec-fetch-site\":\"same-origin\",\"sec-fetch-user\":\"?1\",\"upgrade-insecure-requests\":\"1\",\"user-agent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0\",\"x-forwarded-for\":\"223.181.110.217, 172.70.108.70\",\"x-forwarded-host\":\"httpbin.rs\",\"x-forwarded-port\":\"80\",\"x-forwarded-proto\":\"https\",\"x-forwarded-server\":\"ab65c85a31ae\",\"x-is-trusted\":\"yes\",\"x-real-ip\":\"223.181.110.217\"},\"json\":null,\"method\":\"POST\",\"origin\":\"223.181.110.217\",\"query\":null,\"uri\":\"/post\"}</pre></body></html>",
11 "responseHeaders": {
12 "date": "Fri, 30 May 2025 16:58:07 GMT",
13 "content-type": "application/json; charset=utf-8",
14 "cf-ray": "947fc6437bdfe237-MRS",
15 "server": "cloudflare",
16 "content-encoding": "zstd",
17 "access-control-allow-origin": "https://httpbin.rs",
18 "vary": "Origin",
19 "cf-cache-status": "DYNAMIC",
20 "report-to": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=eUhoz6vNC8yrH4zwf%2FPbaolJQUZ11kO%2BbGKyYYhw1AMo6wJBn%2BobEe%2Fy5KD6Zbz7cn%2B18Yjflsajy40MsUbANQ7AqtDdlfGgkmbwHRUGcK1WpRIw3LueBTl7zEy%2F\"}], \"group\":\"cf-nel\", \"max_age\":604800}",
21 "nel": "{\"success_fraction\":0, \"report_to\":\"cf-nel\", \"max_age\":604800}",
22 "alt-svc": "h3=\":443\"; ma=86400",
23 "server-timing": "cfCacheStatus;desc=\"DYNAMIC\", cfL4;desc=\"?proto=TCP&rtt=195244&min_rtt=136910&rtt_var=69448&sent=29&recv=20&lost=0&retrans=0&sent_bytes=11642&recv_bytes=3211&delivery_rate=60733&cwnd=256&unsent_bytes=0&cid=a544805ada7c1328&ts=4901&x=0\"",
24 "x-firefox-spdy": "h2"
25 },
26 "requestHeaders": {
27 "host": "httpbin.rs",
28 "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0",
29 "accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
30 "accept-language": "en-US,en;q=0.5",
31 "accept-encoding": "gzip, deflate, br, zstd",
32 "content-type": "application/x-www-form-urlencoded",
33 "content-length": "3",
34 "referer": "https://httpbin.rs/",
35 "origin": "https://httpbin.rs",
36 "upgrade-insecure-requests": "1",
37 "sec-fetch-dest": "document",
38 "sec-fetch-mode": "navigate",
39 "sec-fetch-site": "same-origin",
40 "sec-fetch-user": "?1",
41 "connection": "keep-alive"
42 },
43 "requestBody": "a=b",
44 "method": "POST",
45 "type": "browser"
46 },
47 "timeElapsed": 46276,
48 "data": "success",
49 "session": "67142d3a-40dd-4eda-8619-f95603f3bed7"
50}