On this page Overview

List countries

Find the country identifiers used by catalogue and purchase requests.

01 / Request

Make a request

GET/api/v1/countries

Use the id from this response in subsequent requests. Country names and dialling prefixes are display information, not purchase identifiers.

Required headers

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

Authentication guide

Query parameters

This endpoint does not require parameters.

GET /countries

# Set SCRAPINGBUDDY_API_KEY in your server environment.
curl "https://www.scrapingbuddy.com/api/v1/countries" \
  -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 + "/countries", {
  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 + "/countries",
    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.

countriesarray: Supported countries.
countries[].idstring: Country identifier for API requests.
countries[].name / prefixstring: Display name and dialling prefix.
countries[].isostring | null: ISO code for displaying a country flag, when available.

Example response / illustrative values

{
  "countries": [
    {
      "id": "england",
      "name": "England",
      "prefix": "44",
      "iso": "gb"
    }
  ]
}

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