The POST /request endpoint sends HTTP or browser-rendered requests through Unblocker. You specify the target method and url (and optional headers, body, geo, or browser mode); the service applies anti-bot handling, optional egress proxy selection, and returns a JSON envelope with the target response.LLM prompts (ChatGPT, Gemini, Google AI Overview) use a separate endpoint: POST /llm. That call takes source and prompt, not url.Access token: You must bring your own Bearer token (JWT) for every call and for Try it. If you do not have a token yet, see Token acquisition.
Overview
Unblocker POST /request supports:
HTTP methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
Optional country codes to prefer a matching egress proxy
Optional browser: true for JavaScript-rendered HTML
Bearer JWT authentication (gateway maps the token to your tenant)
Monthly request quotas on self-serve plans (HTTP 429 when exceeded)
Endpoint
URL:POST /request Base URL:https://unblocker.bringits.comFull URL: https://unblocker.bringits.com/request
Headers
In Try it, enter your JWT only in Authorize (token field). Do not paste the full Authorization header or duplicate the token in a Headers box.
Header
Sent as
Required
Notes
Content-Type
application/json
Yes
Request body must be JSON.
Authorization
Bearer <access_token>
Yes
Production gateway validates the JWT and injects x-tenant-id from the tenantId claim. You do not set x-tenant-id yourself.
Response headers
Header
When
Description
x-request-id
Every response
UUID for tracing and support, on successes and errors.
HTTP method for the target: GET, POST, PUT, DELETE, PATCH, HEAD, or OPTIONS. Ignored when browser is true.
Yes
url
string
Target URL (must be a valid URL with a host).
Yes
headers
object
Optional headers sent to the target (HTTP path only). Keys are header names; values are strings.
No
body
string
Optional raw body for the target (HTTP path only). For JSON, stringify the payload.
No
countries
string[]
Optional ISO country codes (e.g. ["US","GB"]) used to select an egress proxy. If your pool has no proxy for these countries, the request still runs via direct egress (see How the request is handled).
No
browser
boolean
Default false. When true, loads the page in a headless browser and returns HTML in the response body.
No
How the request is handled
Quota — Monthly usage is checked before proxy selection. Over limit → 429 (no proxy slot used). Usage is incremented only after the target response is successfully read (not on transport or proxy-selection failures).
Proxy — Unblocker selects a proxy for the URL domain and optional countries. If your pool has no proxy for those countries, the request proceeds with direct egress; fingerprint emulation still applies on the HTTP path. Any other proxy-pool problem (for example a pool that is still being created) does not fall back to direct egress: you get 503SERVICE_UNAVAILABLE with Retry-After.
Delivery — browser: false uses an HTTP client with browser-like TLS/fingerprinting through the proxy (or direct). browser: true calls the browser rendering service and returns page HTML.
Response format
Classic scrapes use Content-Type: application/json and this envelope:
{ "status": 200, "headers": { "content-type": "application/json" }, "body": "{ ... target body as string ... }", "error": null}
Field
Success
Error
status
Target HTTP status (integer), or 200 for browser HTML
When the unblocker successfully delivers a classic scrape, the outer HTTP status is 200, even if the target returned 404 or 500. Read the target status from status in the JSON body.
Errors
Errors use the scrape envelope with error set and status / body null. The body carries only the code, no message. error is always one of these nine codes:
HTTP
error
Meaning
Retry?
400
INVALID_REQUEST
The request body or URL is invalid (bad JSON, wrong shape, URL without a host, invalid country code).
No. Fix the request.
401
INVALID_CREDENTIALS
No valid credentials for your account.
No. Check your token.
403
ACCESS_DENIED
Your account is not allowed to make this request.
No.
429
QUOTA_EXCEEDED
Your plan’s monthly request quota is used up.
After Retry-After (quota reset).
429
RATE_LIMITED
Too many requests to this domain from your account right now.
After Retry-After.
502
TARGET_BLOCKED
The target blocked the request or could not be reached through its protection.
Replace <YOUR_ACCESS_TOKEN> with your tenant JWT and set url to the page you want rendered.On success, body contains the rendered HTML string; headers is often {}.
Best practices
Store the token in a secret (e.g. %{LINK_UNBLOCKER_TOKEN}) instead of hardcoding.
Use HTTPS for target url values when possible.
Classic scrapes: check both layers — outer HTTP status (200 vs 4xx/5xx from unblocker) and envelope status (target outcome).
Handle 429: respect Retry-After and surface used / limit / reset_at to users.
Retry by code: wait for Retry-After on 429, 502, and 503; retry 504 with backoff and 500 once. Do not retry 400, 401, or 403 with the same request.
Authenticate – Enter the token in Authorize (Bearer is applied automatically).
Edit the body – Default: {"method":"GET","url":"https://tlsinfo.me/json"}. Try countries or browser as needed.
Send – Inspect the JSON envelope; on success, error is null and target data is under status, headers, and body.
Security: Do not share your token or commit it to code. Use the Authorize
dialog only in your browser; the token is not stored in the documentation.
Base URL
Requests use https://unblocker.bringits.com (shown in the Try it panel as the server URL).
Authorizations
Authorization
string
header
required
Use Authorize and enter your tenant JWT in the token field only. The gateway validates the token and injects x-tenant-id from the tenantId claim; do not set x-tenant-id manually in production.
Body
application/json
method
enum<string>
default:GET
required
HTTP method the unblocker uses when calling the target url (ignored when browser is true).
Available options:
GET,
POST,
PUT,
DELETE,
PATCH,
HEAD,
OPTIONS
Example:
"GET"
url
string<uri>
required
Target URL to request.
Example:
"https://tlsinfo.me/json"
headers
object
Optional headers sent to the target URL (HTTP path only).
Show child attributes
body
string | null
Optional raw request body for the target (HTTP path only). For JSON payloads, stringify the JSON.
countries
string[]
Optional ISO country codes used to select a proxy. If your proxy pool has no proxy for these countries, the request still proceeds using direct egress. Other proxy-pool problems (for example a pool that is still being created) return 503 SERVICE_UNAVAILABLE instead.
browser
boolean
default:false
When true, fetches the page through the headless browser service and returns rendered HTML in body.
Response
Request delivered; target response is in the JSON envelope (error is null). Outer HTTP status is 200 even when the target returned 4xx/5xx — check status in the body.
status
integer | null
required
HTTP status code from the target URL (or 200 for browser HTML success).
Example:
200
headers
object
required
Response headers from the target (may be empty for browser mode).
Show child attributes
body
string | null
required
Response body from the target (HTML string when browser is true).
error
string | null
required
Null on success.
Example:
null
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bringits","colors":{"primary":"#686AFF","light":"#686AFF","dark":"#FFD950"},"logo":{"light":"https://mintcdn.com/bringits/lqwlGX4Jpi7WtU1i/logo/bringits-light.svg?fit=max\u0026auto=format\u0026n=lqwlGX4Jpi7WtU1i\u0026q=85\u0026s=5144e44bec1b52febac176b078afe643","dark":"https://mintcdn.com/bringits/lqwlGX4Jpi7WtU1i/logo/bringits-dark.svg?fit=max\u0026auto=format\u0026n=lqwlGX4Jpi7WtU1i\u0026q=85\u0026s=76a28b264945b3228ff322f1944b4fcb"},"favicon":"https://mintcdn.com/bringits/YjThGAUKpjF9W4m1/logo/Bringits%20%20Fav%20icon.png?fit=max\u0026auto=format\u0026n=YjThGAUKpjF9W4m1\u0026q=85\u0026s=d575ba9b19a85be3708743226cf13ff2","footer":{"socials":{"github":"https://github.com/lsportsltd/bringits-docs","linkedin":"https://www.linkedin.com/company/bringits"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home Page","icon":"house","href":"https://bringits.com"},{"anchor":"Blog","icon":"newspaper","href":"https://bringits.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bringits","hasAudioNarration":false,"actualSubdomain":"bringits","customDomains":["docs.bringits.com"],"gitSource":{"type":"github","owner":"lsportsltd","repo":"bringits-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afaf91deeeb15b4be8f2441","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Stream","count":94},{"language":"default","tag":"Commands Glossary","count":90},{"language":"default","tag":"Browser Commands","count":28},{"language":"default","tag":"Parse Commands","count":24},{"language":"default","tag":"Android Commands","count":6},{"language":"default","tag":"HTTP Commands","count":6},{"language":"default","tag":"Sink Commands","count":6},{"language":"default","tag":"Generate Commands","count":5},{"language":"default","tag":"WebSocket Commands","count":4},{"language":"default","tag":"Quick Start","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"unblocker/request","slug":"/unblocker/request","pageMetadata":{"title":"Request","description":"Make HTTP/HTTPS requests through Unblocker","openapi":"POST /request","mode":"wide","icon":"link","href":"/unblocker/request"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Make HTTP/HTTPS requests through Unblocker\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,br:`br`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`POST /request`}),` endpoint sends HTTP or browser-rendered requests through Unblocker. You specify the target `,_jsx(_components.code,{children:`method`}),` and `,_jsx(_components.code,{children:`url`}),` (and optional headers, body, geo, or browser mode); the service applies anti-bot handling, optional egress proxy selection, and returns a `,_jsx(_components.strong,{children:`JSON envelope`}),` with the target response.`]}),`\n`,_jsxs(_components.p,{children:[`LLM prompts (ChatGPT, Gemini, Google AI Overview) use a separate endpoint: `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/unblocker/llm`,children:`POST /llm`})}),`. That call takes `,_jsx(_components.code,{children:`source`}),` and `,_jsx(_components.code,{children:`prompt`}),`, not `,_jsx(_components.code,{children:`url`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Access token:`}),` You must `,_jsx(_components.strong,{children:`bring your own Bearer token`}),` (JWT) for every call and for `,_jsx(_components.strong,{children:`Try it`}),`. If you do not have a token yet, see `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/unblocker#token-acquisition`,children:`Token acquisition`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Unblocker `,_jsx(_components.strong,{children:`POST /request`}),` supports:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`HTTP methods: `,_jsx(_components.strong,{children:`GET`}),`, `,_jsx(_components.strong,{children:`POST`}),`, `,_jsx(_components.strong,{children:`PUT`}),`, `,_jsx(_components.strong,{children:`DELETE`}),`, `,_jsx(_components.strong,{children:`PATCH`}),`, `,_jsx(_components.strong,{children:`HEAD`}),`, `,_jsx(_components.strong,{children:`OPTIONS`})]}),`\n`,_jsxs(_components.li,{children:[`Optional `,_jsx(_components.strong,{children:`country codes`}),` to prefer a matching egress proxy`]}),`\n`,_jsxs(_components.li,{children:[`Optional `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`browser: true`})}),` for JavaScript-rendered HTML`]}),`\n`,_jsx(_components.li,{children:`Bearer JWT authentication (gateway maps the token to your tenant)`}),`\n`,_jsxs(_components.li,{children:[`Monthly `,_jsx(_components.strong,{children:`request quotas`}),` on self-serve plans (HTTP `,_jsx(_components.strong,{children:`429`}),` when exceeded)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`URL:`}),` `,_jsx(_components.code,{children:`POST /request`}),_jsx(_components.br,{}),`\n`,_jsx(_components.strong,{children:`Base URL:`}),` `,_jsx(_components.code,{children:`https://unblocker.bringits.com`})]}),`\n`,_jsxs(_components.p,{children:[`Full URL: `,_jsx(_components.code,{children:`https://unblocker.bringits.com/request`})]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Try it`}),`, enter your JWT only in `,_jsx(_components.strong,{children:`Authorize`}),` (token field). Do not paste the full `,_jsx(_components.code,{children:`Authorization`}),` header or duplicate the token in a Headers box.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Sent as`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Request body must be JSON.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Authorization`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Bearer \u003caccess_token>`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Production gateway validates the JWT and injects `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`x-tenant-id`})}),` from the `,_jsx(_components.code,{children:`tenantId`}),` claim. You do not set `,_jsx(_components.code,{children:`x-tenant-id`}),` yourself.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-headers`,children:`Response headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`When`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`x-request-id`})}),_jsx(_components.td,{children:`Every response`}),_jsx(_components.td,{children:`UUID for tracing and support, on successes and errors.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`X-RateLimit-Limit`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`QUOTA_EXCEEDED`}),` (429)`]}),_jsx(_components.td,{children:`Your plan’s monthly request cap.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`X-RateLimit-Remaining`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`QUOTA_EXCEEDED`}),` (429)`]}),_jsxs(_components.td,{children:[`Always `,_jsx(_components.code,{children:`0`}),` when quota is exceeded.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`X-RateLimit-Used`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`QUOTA_EXCEEDED`}),` (429)`]}),_jsx(_components.td,{children:`Requests used this billing month.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Retry-After`})}),_jsx(_components.td,{children:`HTTP 429, 502, 503`}),_jsxs(_components.td,{children:[`Seconds to wait before retrying. See `,_jsx(_components.a,{href:`#errors`,children:`Errors`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body-parameters`,children:`Request body parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`method`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`HTTP method for the target: `,_jsx(_components.code,{children:`GET`}),`, `,_jsx(_components.code,{children:`POST`}),`, `,_jsx(_components.code,{children:`PUT`}),`, `,_jsx(_components.code,{children:`DELETE`}),`, `,_jsx(_components.code,{children:`PATCH`}),`, `,_jsx(_components.code,{children:`HEAD`}),`, or `,_jsx(_components.code,{children:`OPTIONS`}),`. Ignored when `,_jsx(_components.code,{children:`browser`}),` is `,_jsx(_components.code,{children:`true`}),`.`]}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Target URL (must be a valid URL with a host).`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`headers`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Optional headers sent to the target (HTTP path only). Keys are header names; values are strings.`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`body`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Optional raw body for the target (HTTP path only). For JSON, stringify the payload.`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`countries`})}),_jsx(_components.td,{children:`string[]`}),_jsxs(_components.td,{children:[`Optional ISO country codes (e.g. `,_jsx(_components.code,{children:`[\"US\",\"GB\"]`}),`) used to select an egress proxy. If your pool has no proxy for these countries, the request still runs via `,_jsx(_components.strong,{children:`direct egress`}),` (see `,_jsx(_components.a,{href:`#how-the-request-is-handled`,children:`How the request is handled`}),`).`]}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`browser`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[`Default `,_jsx(_components.code,{children:`false`}),`. When `,_jsx(_components.code,{children:`true`}),`, loads the page in a headless browser and returns `,_jsx(_components.strong,{children:`HTML`}),` in the response `,_jsx(_components.code,{children:`body`}),`.`]}),_jsx(_components.td,{children:`No`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-request-is-handled`,children:`How the request is handled`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quota`}),` — Monthly usage is checked before proxy selection. Over limit → `,_jsx(_components.strong,{children:`429`}),` (no proxy slot used). Usage is incremented only after the target response is successfully read (not on transport or proxy-selection failures).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Proxy`}),` — Unblocker selects a proxy for the URL domain and optional `,_jsx(_components.code,{children:`countries`}),`. If your pool has no proxy for those countries, the request proceeds with `,_jsx(_components.strong,{children:`direct`}),` egress; fingerprint emulation still applies on the HTTP path. Any other proxy-pool problem (for example a pool that is still being created) does `,_jsx(_components.strong,{children:`not`}),` fall back to direct egress: you get `,_jsx(_components.strong,{children:`503`}),` `,_jsx(_components.code,{children:`SERVICE_UNAVAILABLE`}),` with `,_jsx(_components.code,{children:`Retry-After`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delivery`}),` — `,_jsx(_components.code,{children:`browser: false`}),` uses an HTTP client with browser-like TLS/fingerprinting through the proxy (or direct). `,_jsx(_components.code,{children:`browser: true`}),` calls the browser rendering service and returns page HTML.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-format`,children:`Response format`}),`\n`,_jsxs(_components.p,{children:[`Classic scrapes use `,_jsx(_components.code,{children:`Content-Type: application/json`}),` and this envelope:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"content-type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{ ... target body as string ... }\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Success`}),_jsx(_components.th,{children:`Error`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`status`})}),_jsxs(_components.td,{children:[`Target HTTP status (integer), or `,_jsx(_components.code,{children:`200`}),` for browser HTML`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`headers`})}),_jsx(_components.td,{children:`Target response headers (object)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`body`})}),_jsxs(_components.td,{children:[`Target body as a string (HTML when `,_jsx(_components.code,{children:`browser: true`}),`)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`error`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`null`})}),_jsxs(_components.td,{children:[`Machine-readable code (see `,_jsx(_components.a,{href:`#errors`,children:`Errors`}),`)`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When the unblocker `,_jsx(_components.strong,{children:`successfully delivers`}),` a classic scrape, the `,_jsx(_components.strong,{children:`outer HTTP status is 200`}),`, even if the target returned 404 or 500. Read the target status from `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`status`})}),` in the JSON body.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Errors use the scrape envelope with `,_jsx(_components.code,{children:`error`}),` set and `,_jsx(_components.code,{children:`status`}),` / `,_jsx(_components.code,{children:`body`}),` null. The body carries only the code, no message. `,_jsx(_components.code,{children:`error`}),` is always one of these nine codes:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error`})}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Retry?`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_REQUEST`})}),_jsx(_components.td,{children:`The request body or URL is invalid (bad JSON, wrong shape, URL without a host, invalid country code).`}),_jsx(_components.td,{children:`No. Fix the request.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_CREDENTIALS`})}),_jsx(_components.td,{children:`No valid credentials for your account.`}),_jsx(_components.td,{children:`No. Check your token.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ACCESS_DENIED`})}),_jsx(_components.td,{children:`Your account is not allowed to make this request.`}),_jsx(_components.td,{children:`No.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`QUOTA_EXCEEDED`})}),_jsx(_components.td,{children:`Your plan’s monthly request quota is used up.`}),_jsxs(_components.td,{children:[`After `,_jsx(_components.code,{children:`Retry-After`}),` (quota reset).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`RATE_LIMITED`})}),_jsx(_components.td,{children:`Too many requests to this domain from your account right now.`}),_jsxs(_components.td,{children:[`After `,_jsx(_components.code,{children:`Retry-After`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TARGET_BLOCKED`})}),_jsx(_components.td,{children:`The target blocked the request or could not be reached through its protection.`}),_jsxs(_components.td,{children:[`After `,_jsx(_components.code,{children:`Retry-After`}),` (60 seconds).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_UNAVAILABLE`})}),_jsx(_components.td,{children:`A temporary problem on our side.`}),_jsxs(_components.td,{children:[`After `,_jsx(_components.code,{children:`Retry-After`}),` (5 seconds).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`504`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TARGET_TIMEOUT`})}),_jsx(_components.td,{children:`The target did not answer in time.`}),_jsx(_components.td,{children:`Yes, with backoff.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{children:`The request failed unexpectedly.`}),_jsx(_components.td,{children:`Once. If it persists, contact support.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Example (HTTP 502, with `,_jsx(_components.code,{children:`Retry-After: 60`}),`):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"TARGET_BLOCKED\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`A missing or gone page is the target’s answer, not an error: a target `,_jsx(_components.strong,{children:`404`}),` or `,_jsx(_components.strong,{children:`410`}),` is delivered as outer `,_jsx(_components.strong,{children:`200`}),` with `,_jsx(_components.code,{children:`status`}),` set to the target’s status.`]}),`\n`,_jsx(Heading,{level:`3`,id:`http-429-—-quota-exceeded`,children:`HTTP 429 — quota exceeded`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"QUOTA_EXCEEDED\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"used\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reset_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-01T00:00:00+00:00\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Check `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`X-RateLimit-*`})}),` and `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`Retry-After`})}),` headers. Enterprise tenants are not subject to monthly request quotas.`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage-examples`,children:`Usage examples`}),`\n`,_jsx(Heading,{level:`3`,id:`curl-get-minimal`,children:`cURL: GET (minimal)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -si`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://unblocker.bringits.com/request`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cYOUR_ACCESS_TOKEN>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"method\":\"GET\",\"url\":\"https://tlsinfo.me/json\"}'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`\u003cYOUR_ACCESS_TOKEN>`}),` with a valid tenant JWT.`]}),`\n`,_jsx(Heading,{level:`3`,id:`get-with-custom-headers`,children:`GET with custom headers`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.example.com/data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"Accept\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"X-Request-ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"my-id\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`post-with-body`,children:`POST with body`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POST\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.example.com/items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/json\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`name`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`item1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`quantity`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:2}\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`geo-proxy-preference`,children:`Geo proxy preference`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.example.com/data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countries\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"US\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GB\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`browser-rendered-html-with-geo`,children:`Browser-rendered HTML (with geo)`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`browser: true`}),` for JavaScript-rendered pages. Optional `,_jsx(_components.code,{children:`countries`}),` selects egress (here, Brazil):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://unblocker.bringits.com/request\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer \u003cYOUR_ACCESS_TOKEN>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-raw`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"browser\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"method\": \"GET\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"url\": \"https://example.com/dynamic-page\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"countries\": [\"BR\"]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`\u003cYOUR_ACCESS_TOKEN>`}),` with your tenant JWT and set `,_jsx(_components.code,{children:`url`}),` to the page you want rendered.`]}),`\n`,_jsxs(_components.p,{children:[`On success, `,_jsx(_components.code,{children:`body`}),` contains the rendered HTML string; `,_jsx(_components.code,{children:`headers`}),` is often `,_jsx(_components.code,{children:`{}`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best practices`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Store the token in a secret`}),` (e.g. `,_jsx(_components.code,{children:`%{LINK_UNBLOCKER_TOKEN}`}),`) instead of hardcoding.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use HTTPS`}),` for target `,_jsx(_components.code,{children:`url`}),` values when possible.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Classic scrapes:`}),` check both layers — outer HTTP status (200 vs 4xx/5xx from unblocker) and envelope `,_jsx(_components.code,{children:`status`}),` (target outcome).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Handle 429:`}),` respect `,_jsx(_components.code,{children:`Retry-After`}),` and surface `,_jsx(_components.code,{children:`used`}),` / `,_jsx(_components.code,{children:`limit`}),` / `,_jsx(_components.code,{children:`reset_at`}),` to users.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Retry by code:`}),` wait for `,_jsx(_components.code,{children:`Retry-After`}),` on 429, 502, and 503; retry 504 with backoff and 500 once. Do not retry 400, 401, or 403 with the same request.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Log `,_jsx(_components.code,{children:`x-request-id`})]}),` when opening support tickets.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/unblocker`,children:`Unblocker overview`}),` – Introduction and token acquisition`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/unblocker/llm`,children:`LLM Scraping API`}),` – ChatGPT, Gemini or Google AI Overview prompt (`,_jsx(_components.code,{children:`POST /llm`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/stream/commands/http/http-request`,children:`HTTP Request`}),` – HTTP from a Stream step (without Unblocker)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/stream/commands/parse`,children:`Parse Commands`}),` – Parse JSON or other response bodies`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`try-it`,children:`Try it`}),`\n`,_jsxs(_components.p,{children:[`Use the interactive `,_jsx(_components.strong,{children:`Try it`}),` panel below to send a real request.`]}),`\n`,_jsx(Heading,{level:`3`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Get a token`}),` – See `,_jsx(_components.a,{href:`/unblocker#token-acquisition`,children:`Token acquisition`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Authenticate`}),` – Enter the token in `,_jsx(_components.strong,{children:`Authorize`}),` (Bearer is applied automatically).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Edit the body`}),` – Default: `,_jsx(_components.code,{children:`{\"method\":\"GET\",\"url\":\"https://tlsinfo.me/json\"}`}),`. Try `,_jsx(_components.code,{children:`countries`}),` or `,_jsx(_components.code,{children:`browser`}),` as needed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Send`}),` – Inspect the JSON envelope; on success, `,_jsx(_components.code,{children:`error`}),` is `,_jsx(_components.code,{children:`null`}),` and target data is under `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`headers`}),`, and `,_jsx(_components.code,{children:`body`}),`.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Security:`}),` Do not share your token or commit it to code. Use the Authorize\ndialog only in your browser; the token is not stored in the documentation.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`base-url`,children:`Base URL`}),`\n`,_jsxs(_components.p,{children:[`Requests use `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`https://unblocker.bringits.com`})}),` (shown in the Try it panel as the server URL).`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Request","description":"Make HTTP/HTTPS requests through Unblocker","openapi":"POST /request","mode":"wide","icon":"link","href":"/unblocker/request"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[{"title":"Response headers","slug":"response-headers","depth":3,"children":[]}]},{"title":"Request body parameters","slug":"request-body-parameters","depth":2,"children":[]},{"title":"How the request is handled","slug":"how-the-request-is-handled","depth":2,"children":[]},{"title":"Response format","slug":"response-format","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[{"title":"HTTP 429 — quota exceeded","slug":"http-429-—-quota-exceeded","depth":3,"children":[]}]},{"title":"Usage examples","slug":"usage-examples","depth":2,"children":[{"title":"cURL: GET (minimal)","slug":"curl-get-minimal","depth":3,"children":[]},{"title":"GET with custom headers","slug":"get-with-custom-headers","depth":3,"children":[]},{"title":"POST with body","slug":"post-with-body","depth":3,"children":[]},{"title":"Geo proxy preference","slug":"geo-proxy-preference","depth":3,"children":[]},{"title":"Browser-rendered HTML (with geo)","slug":"browser-rendered-html-with-geo","depth":3,"children":[]}]},{"title":"Best practices","slug":"best-practices","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]},{"title":"Try it","slug":"try-it","depth":2,"children":[{"title":"Before you start","slug":"before-you-start","depth":3,"children":[]},{"title":"Base URL","slug":"base-url","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Scrape / request (Unblocker)","description":"Make HTTP/HTTPS requests through Unblocker","operationId":"postRequest","tags":["Request"],"requestBody":"e5db4b4a-487f-471a-ac96-d18542d4ff22","responses":{"200":"75a82235-94a4-40f9-975a-82d764fb5150","400":"19158c6b-018e-4917-8dc2-abf85fdfbb73","401":"f357d017-f9f8-423e-97c3-b0e281c6e05b","403":"ba1e9f29-fd31-4b56-9383-bb5d247b214a","429":"803531d8-099c-42e8-accd-49cf08df7fda","500":"43ca4f38-901e-4ad7-8c46-ed745e38299d","502":"32f8949c-90f8-480e-9ed3-fccc0988d1bd","503":"fe0bf0ca-d11b-4490-88e5-5e694f5525f4","504":"2d3eb637-208a-443b-b4e4-7adb12c9bd20"},"method":"post","type":"path","servers":["9245a258-38b6-4bd0-ac69-f6351b48cf02"],"security":["daa23641-b6f4-467a-b21f-cccf1a3f03a5"],"path":"/request","baseUrlOptions":["https://unblocker.bringits.com"],"title":"Scrape / request (Unblocker)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["method","url"],"properties":{"method":{"type":"string","enum":["GET","POST","PUT","DELETE","PATCH","HEAD","OPTIONS"],"default":"GET","description":"HTTP method the unblocker uses when calling the target `url` (ignored when `browser` is true).","example":"GET","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"Target URL to request.","example":"https://tlsinfo.me/json","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"description":"Optional headers sent to the target URL (HTTP path only).","uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","description":"Optional raw request body for the target (HTTP path only). For JSON payloads, stringify the JSON.","uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional raw request body for the target (HTTP path only). For JSON payloads, stringify the JSON.","uniqueKey":"body.oneOf.1","typeLabel":"null"}],"uniqueKey":"body","typeLabel":"string | null"},"countries":{"type":"array","items":{"type":"string","uniqueKey":"countries.items.[INDEX]","typeLabel":"string"},"description":"Optional ISO country codes used to select a proxy. If your proxy pool has no proxy for these countries, the request still proceeds using direct egress. Other proxy-pool problems (for example a pool that is still being created) return 503 `SERVICE_UNAVAILABLE` instead.","uniqueKey":"countries","typeLabel":"string[]"},"browser":{"type":"boolean","default":false,"description":"When true, fetches the page through the headless browser service and returns rendered HTML in `body`.","uniqueKey":"browser","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"getMinimal":{"title":"getMinimal","summary":"GET (minimal)","value":{"method":"GET","url":"https://tlsinfo.me/json"}},"getWithCountries":{"title":"getWithCountries","summary":"GET with geo proxy filter","value":{"method":"GET","url":"https://api.example.com/data","countries":["US","GB"]}},"browser":{"title":"browser","summary":"Browser-rendered HTML with geo","value":{"browser":true,"method":"GET","url":"https://example.com/dynamic-page","countries":["BR"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"75a82235-94a4-40f9-975a-82d764fb5150":{"description":"Request delivered; target response is in the JSON envelope (`error` is null). Outer HTTP status is 200 even when the target returned 4xx/5xx — check `status` in the body.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","description":"HTTP status code from the target URL (or 200 for browser HTML success).","example":200,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","description":"HTTP status code from the target URL (or 200 for browser HTML success).","example":200,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"description":"Response headers from the target (may be empty for browser mode).","isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","description":"Response body from the target (HTML string when `browser` is true).","isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","description":"Response body from the target (HTML string when `browser` is true).","isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","description":"Null on success.","example":null,"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Null on success.","example":null,"isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":200,"headers":{},"body":"\u003cstring>","error":null}}},"exampleType":"generated"}},"exampleType":"generated"},"19158c6b-018e-4917-8dc2-abf85fdfbb73":{"description":"`INVALID_REQUEST`: the request body or URL is invalid (bad JSON, wrong shape, URL without a host, invalid country code). Fix the request; do not retry it unchanged.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"INVALID_REQUEST":{"title":"INVALID_REQUEST","value":{"status":null,"headers":{},"body":null,"error":"INVALID_REQUEST"}}},"exampleType":"examples"}},"exampleType":"examples"},"f357d017-f9f8-423e-97c3-b0e281c6e05b":{"description":"`INVALID_CREDENTIALS`: no valid credentials for your account. Check the Bearer token.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"INVALID_CREDENTIALS":{"title":"INVALID_CREDENTIALS","value":{"status":null,"headers":{},"body":null,"error":"INVALID_CREDENTIALS"}}},"exampleType":"examples"}},"exampleType":"examples"},"ba1e9f29-fd31-4b56-9383-bb5d247b214a":{"description":"`ACCESS_DENIED`: your account is not allowed to make this request.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"ACCESS_DENIED":{"title":"ACCESS_DENIED","value":{"status":null,"headers":{},"body":null,"error":"ACCESS_DENIED"}}},"exampleType":"examples"}},"exampleType":"examples"},"803531d8-099c-42e8-accd-49cf08df7fda":{"description":"`QUOTA_EXCEEDED`: the monthly request quota of your plan is used up (body adds `used`, `limit`, `reset_at`). `RATE_LIMITED`: too many requests to this domain from your account right now. Retry after `Retry-After`.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}},"X-RateLimit-Limit":{"description":"`QUOTA_EXCEEDED` only. Monthly request cap for the tenant plan.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"`QUOTA_EXCEEDED` only. Always 0.","schema":{"type":"integer"}},"X-RateLimit-Used":{"description":"`QUOTA_EXCEEDED` only. Requests used in the current billing month.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait. `QUOTA_EXCEEDED`: until the quota resets (UTC midnight on the first day of the next month). `RATE_LIMITED`: until the domain limit allows the next request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["used","limit","status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"oneOf.0.status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"oneOf.0.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"oneOf.0.headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"oneOf.0.headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"oneOf.0.body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"oneOf.0.body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"example":"QUOTA_EXCEEDED","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"enum\u003cstring>"},"used":{"type":"integer","description":"Requests used in the current billing month.","isRequired":true,"uniqueKey":"oneOf.0.used","typeLabel":"integer"},"limit":{"type":"integer","description":"Monthly request cap for the tenant plan.","isRequired":true,"uniqueKey":"oneOf.0.limit","typeLabel":"integer"},"reset_at":{"type":"string","format":"date-time","description":"UTC timestamp when the monthly quota resets. Present on POST /request 429. Omitted on POST /llm 429 today.","uniqueKey":"oneOf.0.reset_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"oneOf.1.status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"oneOf.1.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"oneOf.1.headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"oneOf.1.headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"oneOf.1.body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"oneOf.1.body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"QUOTA_EXCEEDED":{"title":"QUOTA_EXCEEDED","value":{"status":null,"headers":{},"body":null,"error":"QUOTA_EXCEEDED","used":10000,"limit":10000,"reset_at":"2026-11-01T00:00:00+00:00"}},"RATE_LIMITED":{"title":"RATE_LIMITED","value":{"status":null,"headers":{},"body":null,"error":"RATE_LIMITED"}}},"exampleType":"examples"}},"exampleType":"examples"},"43ca4f38-901e-4ad7-8c46-ed745e38299d":{"description":"`INTERNAL_ERROR`: the request failed unexpectedly. Retry once; if it persists, contact support with the `x-request-id`.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"INTERNAL_ERROR":{"title":"INTERNAL_ERROR","value":{"status":null,"headers":{},"body":null,"error":"INTERNAL_ERROR"}}},"exampleType":"examples"}},"exampleType":"examples"},"32f8949c-90f8-480e-9ed3-fccc0988d1bd":{"description":"`TARGET_BLOCKED`: the target blocked the request or could not be reached through its protection. Retry after `Retry-After`.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying (60).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"TARGET_BLOCKED":{"title":"TARGET_BLOCKED","value":{"status":null,"headers":{},"body":null,"error":"TARGET_BLOCKED"}}},"exampleType":"examples"}},"exampleType":"examples"},"fe0bf0ca-d11b-4490-88e5-5e694f5525f4":{"description":"`SERVICE_UNAVAILABLE`: a temporary problem on our side. Retry after `Retry-After`.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}},"Retry-After":{"description":"Seconds to wait before retrying (5).","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"SERVICE_UNAVAILABLE":{"title":"SERVICE_UNAVAILABLE","value":{"status":null,"headers":{},"body":null,"error":"SERVICE_UNAVAILABLE"}}},"exampleType":"examples"}},"exampleType":"examples"},"2d3eb637-208a-443b-b4e4-7adb12c9bd20":{"description":"`TARGET_TIMEOUT`: the target did not answer in time. Retry with backoff.","headers":{"x-request-id":{"description":"Unique ID for this request. Present on every POST /request and POST /llm response, including errors. Include it when contacting support.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","required":["status","headers","body","error"],"properties":{"status":{"oneOf":[{"type":"integer","example":null,"isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"integer"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"status","typeLabel":"integer | null"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"headers.additionalProperties","typeLabel":"string"},"example":{},"isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"body":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"body.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"body.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"body","typeLabel":"string | null"},"error":{"type":"string","description":"Machine-readable error code. POST /request returns only these nine codes.","enum":["INVALID_REQUEST","INVALID_CREDENTIALS","ACCESS_DENIED","RATE_LIMITED","QUOTA_EXCEEDED","TARGET_BLOCKED","TARGET_TIMEOUT","SERVICE_UNAVAILABLE","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"TARGET_TIMEOUT":{"title":"TARGET_TIMEOUT","value":{"status":null,"headers":{},"body":null,"error":"TARGET_TIMEOUT"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"daa23641-b6f4-467a-b21f-cccf1a3f03a5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Use **Authorize** and enter your tenant JWT in the token field only. The gateway validates the token and injects `x-tenant-id` from the `tenantId` claim; do not set `x-tenant-id` manually in production.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"9245a258-38b6-4bd0-ac69-f6351b48cf02":{"url":"https://unblocker.bringits.com","description":"Unblocker Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Use **Authorize** and enter your tenant JWT in the token field only. The gateway validates the token and injects `x-tenant-id` from the `tenantId` claim; do not set `x-tenant-id` manually in production.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use **Authorize** and enter your tenant JWT in the token field only. The gateway validates the token and injects `x-tenant-id` from the `tenantId` claim; do not set `x-tenant-id` manually in production.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"unblocker/openapi.json"},"subdomain":"bringits","siteName":"Bringits","title":"Request - Bringits","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T12:37:55.224Z","originalFileLocation":"unblocker/request.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Make HTTP/HTTPS requests through Unblocker\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bringits\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Request - Bringits\">\u003cmeta data-mint-head property=\"og:description\" content=\"Make HTTP/HTTPS requests through Unblocker\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bringits\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bringits.com/unblocker/request\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bringits.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Request\u0026amp;description=Make+HTTP%2FHTTPS+requests+through+Unblocker\u0026amp;theme=e9424b5baef9662be1a55d42\u0026amp;signature=099aa5d4338ef9fa8ba21d1af1a2d9262df0d62663c9d059d06906923c2346ef\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Request - Bringits\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Make HTTP/HTTPS requests through Unblocker\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bringits.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Request\u0026amp;description=Make+HTTP%2FHTTPS+requests+through+Unblocker\u0026amp;theme=e9424b5baef9662be1a55d42\u0026amp;signature=099aa5d4338ef9fa8ba21d1af1a2d9262df0d62663c9d059d06906923c2346ef\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bringits/Ds3YL4rEZMFsSvjS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bringits\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#686AFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bringits.com/unblocker/request\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/unblocker/request.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bringits.com/#organization\",\"name\":\"Bringits\",\"url\":\"https://docs.bringits.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bringits/lqwlGX4Jpi7WtU1i/logo/bringits-light.svg?fit=max\u0026auto=format\u0026n=lqwlGX4Jpi7WtU1i\u0026q=85\u0026s=5144e44bec1b52febac176b078afe643\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bringits.com#website\",\"name\":\"Bringits\",\"url\":\"https://docs.bringits.com\",\"publisher\":{\"@id\":\"https://docs.bringits.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bringits.com/unblocker/request#webpage\",\"url\":\"https://docs.bringits.com/unblocker/request\",\"name\":\"Request\",\"description\":\"Make HTTP/HTTPS requests through Unblocker\",\"dateModified\":\"2026-11-16T12:37:55.224Z\",\"isPartOf\":{\"@id\":\"https://docs.bringits.com#website\"}},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bringits.com/unblocker/request#apireference\",\"headline\":\"Request\",\"name\":\"Request\",\"description\":\"Make HTTP/HTTPS requests through Unblocker\",\"url\":\"https://docs.bringits.com/unblocker/request\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bringits.com/unblocker/request#webpage\"},\"dateModified\":\"2026-11-16T12:37:55.224Z\",\"publisher\":{\"@id\":\"https://docs.bringits.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bringits.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bringits\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bringits\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/unblocker/request.md","siteName":"Bringits","nav":{"global":{"anchors":[{"anchor":"Home Page","icon":"house","href":"https://bringits.com"},{"anchor":"Blog","icon":"newspaper","href":"https://bringits.com/blog"}]},"tabs":[{"tab":"Welcome","pages":[{"title":"Welcome","href":""}]},{"tab":"Stream","pages":[{"title":"Stream","href":"/stream/quickstart/intro"}]},{"tab":"Unblocker","pages":[{"title":"Unblocker","description":"Bringits Unblocker overview and token acquisition","icon":"link","href":"/unblocker"},{"title":"Request","openapi":"POST /request","mode":"wide","icon":"link","href":"/unblocker/request"},{"title":"LLM Scraping API","description":"Send a prompt to ChatGPT, Gemini or Google AI Overview through the LLM Scraping API","openapi":"POST /llm","mode":"wide","icon":"message","href":"/unblocker/llm"},{"title":"MCP (AI Agent Access)","href":"/unblocker/mcp"}],"groups":[{"group":"Request","pages":[{"title":"Scrape / request (Unblocker)","deprecated":null,"version":null,"openapi":"/unblocker/openapi.json post /request","href":"/api-reference/request/scrape-request-unblocker"}]},{"group":"LLM","pages":[{"title":"LLM prompt (LLM Scraping API)","deprecated":null,"version":null,"openapi":"/unblocker/openapi.json post /llm","href":"/api-reference/llm/llm-prompt-llm-scraping-api"}]}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes"}]}]},"basePath":"","title":"Request - Bringits","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-BIYvYBgk.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}