On this page Overview

List services

Find service IDs, stock and indicative prices for a country.

First integration?Open dashboard

01 / Request

Make a request

GET/api/v1/services

Catalogue prices are indicative, not a purchase commitment. Always create a fresh quote before purchasing.

Stock can change between requests. A positive available count does not reserve a number.

Required headers

AuthorizationstringRequired: Bearer followed by your ScrapingBuddy customer API key. Keep it on your server.

Authentication guide

Query parameters

countrystringRequired: Country ID returned by List countries, for example england. Use the ID, not the display name.

GET /services

# Set SCRAPINGBUDDY_API_KEY in your server environment.
curl "https://www.scrapingbuddy.com/api/v1/services?country=england" \
  -H "Authorization: Bearer $SCRAPINGBUDDY_API_KEY"

Node.js 20+

// Node.js 20+. Keep credentials on your server.
const base = "https://www.scrapingbuddy.com/api/v1";
const response = await fetch(base + "/services?country=england", {
  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 + requests

# 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 + "/services?country=england",
    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.

services[].id / namestring: Use id as product when quoting. name is for display.
services[].availableinteger: Reported stock at the time of the catalogue check.
services[].priceCentsinteger | null: Indicative USD-cent price, or null if no price is available.
currencystring: USD.

Example response / illustrative values

{
  "services": [
    {
      "id": "google",
      "name": "Google",
      "available": 12,
      "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.

Errors & limits Safe purchases & retries Order lifecycle