Scraping API Quickstart

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:

Field	Required	Default	Description
`method`	No	Matches request method	Override HTTP method
`headers`	No	`{}`	Custom headers sent to the target origin
`body`	No	`""`	Request body sent to the target
`timeout`	No	`30`	Request timeout in seconds
`allow_redirects`	No	`true`	Follow 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.

Getting Started

Reference

Scraping API Quickstart

Step 1: Check the network

Step 2: Make an HTTP GET request

Step 3: POST with a custom body and headers

Step 4: Target a specific country

Step 5: Check domain health

Step 6: Preview agent selection

Step 7: Check your usage

Next steps

Browser rendering

WebSocket & AMQP

Error handling

​Step 1: Check the network

​Step 2: Make an HTTP GET request

​Step 3: POST with a custom body and headers

​Step 4: Target a specific country

​Step 5: Check domain health

​Step 6: Preview agent selection

​Step 7: Check your usage

​Next steps

Browser rendering

WebSocket & AMQP

Error handling

Step 1: Check the network

Step 2: Make an HTTP GET request

Step 3: POST with a custom body and headers

Step 4: Target a specific country

Step 5: Check domain health

Step 6: Preview agent selection

Step 7: Check your usage

Next steps