Platforms

Which retailers and marketplaces are live, their id fields, endpoints, tiers and prices. Public: no key needed.

Endpoints

How it works, when to use what, and what it costs: Platforms & marketplaces. Base URL, authentication and errors: Overview.

GET /v1/platforms

List platforms and marketplaces. No API key needed.

Every platform this API reads, its marketplaces (each with its currency), and the endpoints each marketplace offers, live or coming_soon, with tiers and prices. Public: no key needed. Use it to discover coverage instead of hard-coding it.

Request

curl "https://api.scrapelyserp.com/v1/platforms"

import requests

r = requests.get(
    "https://api.scrapelyserp.com/v1/platforms",
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch('https://api.scrapelyserp.com/v1/platforms', {
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "object": "list",
  "data": [
    {
      "id": "bestbuy",
      "object": "platform",
      "name": "Best Buy",
      "status": "live",
      "id_field": "ids",
      "id_name": "SKU",
      "default_marketplace": "us",
      "endpoints": [
        {
          "id": "products",
          "name": "Product data",
          "route": "POST /v1/products",
          "status": "live",
          "tiers": [
            {
              "id": "standard",
              "name": "Standard",
              "credits_per_item": 1,
              "max_items_per_call": 1000
            }
          ]
        }
      ],
      "marketplaces": [
        {
          "code": "us",
          "name": "Best Buy US",
          "country": "US",
          "currency": "USD",
          "status": "live",
          "endpoints": {
            "products": "live"
          }
        },
        {
          "code": "ca",
          "name": "Best Buy Canada",
          "country": "CA",
          "currency": "CAD",
          "status": "coming_soon",
          "endpoints": {
            "products": "coming_soon"
          }
        }
      ]
    }
  ]
}

Responses

Response fields