Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.55-tech.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Step 1: Check the network

See which agents are available: 
curl -H "X-API-Key: YOUR_API_KEY" \
  https://scraping-api.55-tech.com/network/status

{
  "total_nodes": 80,
  "total_countries": 12,
  "nodes_by_country": {
    "AT": 22,
    "DE": 20,
    "US": 7,
    "IT": 5,
    "UK": 4,
    "AU": 3,
    "GR": 3,
    "ES": 2,
    "FR": 2,
    "BG": 1,
    "BR": 1,
    "PL": 1
  }
}

​
Step 2: Make an HTTP GET request

Fetch a URL through the agent network using the X-Target-URL header: 
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Target-URL: https://httpbin.org/headers" \
  https://scraping-api.55-tech.com/fetch

{
  "meta": {
    "status": 200,
    "final_url": "https://httpbin.org/headers",
    "http_version": "HTTP/2",
    "elapsed_ms": 312,
    "blocked": false,
    "headers": { "content-type": "application/json" },
    "agent": { "id": "scraping-de5" },
    "bytes": 128
  },
  "raw": null,
  "raw_json": {
    "headers": {
      "Accept": "*/*",
      "Host": "httpbin.org"
    }
  }
}
JSON responses are automatically parsed into raw_json.

​
Step 3: POST with a custom body and headers

Use POST /fetch with a JSON body to send custom headers, body, and method to the target: 
curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Target-URL: https://httpbin.org/post" \
  -H "Content-Type: application/json" \
  -d '{
    "headers": {
      "Authorization": "Bearer my-token",
      "Accept": "application/json"
    },
    "body": "{\"key\": \"value\"}",
    "timeout": 30
  }' \
  https://scraping-api.55-tech.com/fetch
POST body fields:
FieldRequiredDefaultDescription
methodNoMatches request methodOverride HTTP method
headersNo{}Custom headers sent to the target origin
bodyNo""Request body sent to the target
timeoutNo30Request timeout in seconds
allow_redirectsNotrueFollow redirects

​
Step 4: Target a specific country

Use X-Geo to route through agents in specific countries: 
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Target-URL: https://httpbin.org/headers" \
  -H "X-Geo: US" \
  https://scraping-api.55-tech.com/fetch
Pin to a specific agent with X-Agent: 
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Target-URL: https://httpbin.org/headers" \
  -H "X-Agent: de1" \
  https://scraping-api.55-tech.com/fetch
Or pick randomly from a set of agents: 
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Target-URL: https://httpbin.org/headers" \
  -H "X-Agent: de1,at5,us3" \
  https://scraping-api.55-tech.com/fetch

​
Step 5: Check domain health

See which agents can reach a specific domain: 
curl -H "X-API-Key: YOUR_API_KEY" \
  https://scraping-api.55-tech.com/network/health/example.com

{
  "domain": "example.com",
  "nodes_checked": 62,
  "available": 58,
  "limited": 2,
  "unavailable": 2,
  "details": [
    {
      "node_id": "scraping-de1",
      "slug": "de1",
      "state": "available",
      "rtt_ms": 145,
      "last_check": "2026-03-13T22:15:00Z"
    }
  ]
}

​
Step 6: Preview agent selection

Debug which agent would be picked without making the actual request: 
curl -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Geo: US" \
  "https://scraping-api.55-tech.com/debug/pick?url=https://example.com"

{
  "node_id": "scraping-us3",
  "node_slug": "us3",
  "country": "US",
  "valid_until_epoch_ms": 1710374100000
}

​
Step 7: Check your usage

curl -H "X-API-Key: YOUR_API_KEY" \
  https://scraping-api.55-tech.com/usage

{
  "api_key": "YOUR_KEY",
  "total": 15243,
  "success": 14821,
  "fail": 422,
  "success_rate": 97.2,
  "bytes_transferred": 1847362541,
  "rate_limit": {
    "rps": 10.0,
    "burst": 10,
    "remaining": 9.3
  },
  "by_protocol": {
    "fetch": 14200,
    "ws": 923,
    "amqp": 120
  },
  "top_domains": [
    { "domain": "example.com", "requests": 4521 }
  ]
}

​
Next steps

Browser rendering

Render JavaScript-heavy pages with a real browser.

WebSocket & AMQP

Relay WebSocket connections and consume AMQP streams.

Error handling

Status codes, block detection, and retry strategies.