Request Response Errors & next steps 01 / Request
Make a request GET /api/v1/operators
Pass an operator id to Create a quote when you need a specific operator. Omit operator or use any for automatic selection.
Changing the country, service or operator requires a new quote.
Required headers Authentication guide Query parameters countrystring Required Country ID returned by List countries, for example england. Use the ID, not the display name. productstring Required Service ID returned by List services for your country, for example google. cURL JavaScript Python
# Set SCRAPINGBUDDY_API_KEY in your server environment. curl "https://www.scrapingbuddy.com/api/v1/operators?country=england&product=google" \ -H "Authorization: Bearer $SCRAPINGBUDDY_API_KEY " // Node.js 20+. Keep credentials on your server. const base = "https://www.scrapingbuddy.com/api/v1" ; const response = await fetch (base + "/operators?country=england&product=google" , { method: "GET" , headers: { Authorization: "Bearer " + process.env. SCRAPINGBUDDY_API_KEY , }, signal: AbortSignal. timeout ( 30000 ), }); const data = await response. json (); if ( ! response.ok) throw new Error (response.status + ": " + data.error); console. log (data); # Python 3. Install: pip install requests import os import requests base = "https://www.scrapingbuddy.com/api/v1" headers = { "Authorization" : "Bearer " + os.environ[ "SCRAPINGBUDDY_API_KEY" ]} response = requests.get( base + "/operators?country=england&product=google" , headers = headers, timeout = 30 , ) response.raise_for_status() data = response.json() print (data) Base URL https://www.scrapingbuddy.com/api/v1
Set the environment variables shown in the example. Python requires requests; JavaScript requires Node.js 20+. These examples call the live API, not a sandbox.
02 / Response
Understand the response Success returns HTTP 200 with JSON. Read the fields below before using the result.
Example response / illustrative values { "operators" : [ { "id" : "example-operator" , "available" : 8 , "priceCents" : 25 } ], "currency" : "USD" } Prices, stock, phone numbers, messages and timestamps here are illustrative, not live availability or a price guarantee.
Errors & next steps Failures return an HTTP error status and a JSON error message. Correct validation and authentication errors before retrying. For 429, honor Retry-After; longer account limits may still apply.
All keys share the account limit of 60 API requests per minute. Purchase recovery must keep the original idempotency key and quote ID.