POST
$0.01 default
/fetchDescription
Pay $0.01 USDC to make an outbound HTTP request through the proxy. Supports all standard HTTP methods, custom headers (including auth), and JSON or raw bodies. Responses are returned as text or base64-encoded binary. Max response size 10 MB, timeout 30s. Each request performs one upstream fetch and returns the final URL plus response metadata.
Pricing
$0.01 default
Request schema
{
"properties": {
"body": {
"description": "Optional raw string request body. Mutually exclusive with body_json.",
"type": "string"
},
"body_json": {
"description": "Optional JSON request body. Automatically sets Content-Type: application/json and is mutually exclusive with body.",
"type": "object"
},
"headers": {
"description": "Optional custom upstream request headers as key→value string pairs.",
"type": "object"
},
"method": {
"description": "HTTP method for this outbound request. Allowed: DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT",
"enum": [
"DELETE",
"GET",
"HEAD",
"OPTIONS",
"PATCH",
"POST",
"PUT"
],
"type": "string"
},
"timeout": {
"description": "Optional upstream request timeout in seconds (max 30s).",
"type": "number"
},
"url": {
"description": "Target public http:// or https:// URL to fetch.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}Example response
{
"body": "{\"json\":{\"hello\":\"world\"}}",
"body_base64": null,
"elapsed_ms": 312,
"headers": {
"content-type": "application/json"
},
"is_binary": false,
"redirects": 0,
"status": 200,
"url": "https://httpbin.org/post"
}