Structured data

Popular page types — products, search results, listings — as typed JSON, for a flat price per call.

Popular page types — products, search results, listings — as typed JSON, for a flat price per call.

Overview

Coming soon: These endpoints are not live yet: each answers 501 NOT_IMPLEMENTED with "message": "Coming soon" and "coming_soon": true, and charges nothing. Amazon product data is live today as the Amazon Product API (POST /v1/products), which replaces /v1/structured/amazon/product.

Each endpoint will take the identifiers you already have (a query, an item id) and return stable, typed JSON. 5 credits per call, flat: choosing proxies and rendering for the site is our job. Failed calls are free.

Endpoint

Status

Returns

amazon/search

Coming soon

Search results for a query: position, title, price, rating, sponsored flag.

google/search

Coming soon

A Google results page (SERP): organic results, related searches, People Also Ask.

google/shopping

Coming soon

Shopping results for a query: product, price, merchant, rating.

walmart/product

Coming soon

A Walmart product page by item id: title, price, rating, availability, specifications.

walmart/search

Coming soon

Walmart search results for a query.

ebay/product

Coming soon

An eBay listing by item id: price, shipping, condition, seller feedback, auction state.

ebay/search

Coming soon

eBay search results for a query.

GET /v1/structured lists them, with parameters and status (live or coming_soon), for SDKs that discover rather than hard-code.

Coming soon: GET /v1/structured/amazon/search answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

Search results for a query: position, title, price, rating, sponsored flag. GET /v1/structured/amazon/search

Parameter

Type

Default

Description

query (required)

string

—

The search terms.

page

integer

1

Results page, 1–100.

country

enum

us

Marketplace / locale to query.

cURL

curl "https://api.scrapely.dev/v1/structured/amazon/search?query=wireless+earbuds&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "amazon/search",
  "url": "https://www.amazon.com/s?k=wireless%20earbuds&page=1",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "query": "wireless earbuds",
    "page": 1,
    "total_results": 48884,
    "results": [
      {
        "position": 1,
        "title": "Kestrel wireless earbuds Pro",
        "url": "https://www.amazon.com/dp/B00009QKXA",
        "price": {
          "amount": 163.92,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 4293,
        "sponsored": true
      },
      {
        "position": 2,
        "title": "Vertex wireless earbuds Plus",
        "url": "https://www.amazon.com/dp/B00012PO64",
        "price": {
          "amount": 125.99,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews_count": 2076,
        "sponsored": true
      },
      {
        "position": 3,
        "title": "Northwind wireless earbuds Mini",
        "url": "https://www.amazon.com/dp/B0001MUUM6",
        "price": {
          "amount": 137.65,
          "currency": "USD"
        },
        "rating": 4.2,
        "reviews_count": 8409,
        "sponsored": false
      },
      {
        "position": 4,
        "title": "Acme wireless earbuds Max",
        "url": "https://www.amazon.com/dp/B00000MR0O",
        "price": {
          "amount": 109.81,
          "currency": "USD"
        },
        "rating": 3.2,
        "reviews_count": 6204,
        "sponsored": false
      },
      {
        "position": 5,
        "title": "Northwind wireless earbuds Pro",
        "url": "https://www.amazon.com/dp/B0001LTPKO",
        "price": {
          "amount": 125.09,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 5850,
        "sponsored": false
      },
      {
        "position": 6,
        "title": "Kestrel wireless earbuds Plus",
        "url": "https://www.amazon.com/dp/B0001BF9QQ",
        "price": {
          "amount": 154.35,
          "currency": "USD"
        },
        "rating": 4.8,
        "reviews_count": 3907,
        "sponsored": false
      },
      {
        "position": 7,
        "title": "Vertex wireless earbuds Mini",
        "url": "https://www.amazon.com/dp/B0000Y4WSP",
        "price": {
          "amount": 108.33,
          "currency": "USD"
        },
        "rating": 3.5,
        "reviews_count": 7938,
        "sponsored": false
      },
      {
        "position": 8,
        "title": "Kestrel wireless earbuds Max",
        "url": "https://www.amazon.com/dp/B0000JDM5L",
        "price": {
          "amount": 147.84,
          "currency": "USD"
        },
        "rating": 4,
        "reviews_count": 8134,
        "sponsored": false
      },
      {
        "position": 9,
        "title": "Northwind wireless earbuds Pro",
        "url": "https://www.amazon.com/dp/B000033347",
        "price": {
          "amount": 88,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 3702,
        "sponsored": false
      },
      {
        "position": 10,
        "title": "Kestrel wireless earbuds Plus",
        "url": "https://www.amazon.com/dp/B0000I2J0G",
        "price": {
          "amount": 297.81,
          "currency": "USD"
        },
        "rating": 4.1,
        "reviews_count": 9557,
        "sponsored": false
      },
      {
        "position": 11,
        "title": "Kestrel wireless earbuds Mini",
        "url": "https://www.amazon.com/dp/B0001HQ8A9",
        "price": {
          "amount": 195.37,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews_count": 2392,
        "sponsored": false
      },
      {
        "position": 12,
        "title": "Lumen wireless earbuds Max",
        "url": "https://www.amazon.com/dp/B0000ZNCKX",
        "price": {
          "amount": 211.62,
          "currency": "USD"
        },
        "rating": 4,
        "reviews_count": 8074,
        "sponsored": false
      },
      {
        "position": 13,
        "title": "Lumen wireless earbuds Pro",
        "url": "https://www.amazon.com/dp/B00012NZT9",
        "price": {
          "amount": 127.36,
          "currency": "USD"
        },
        "rating": 5,
        "reviews_count": 1228,
        "sponsored": false
      },
      {
        "position": 14,
        "title": "Vertex wireless earbuds Plus",
        "url": "https://www.amazon.com/dp/B0001L3VZ1",
        "price": {
          "amount": 138.66,
          "currency": "USD"
        },
        "rating": 3.9,
        "reviews_count": 4729,
        "sponsored": false
      },
      {
        "position": 15,
        "title": "Lumen wireless earbuds Mini",
        "url": "https://www.amazon.com/dp/B00007932V",
        "price": {
          "amount": 141.66,
          "currency": "USD"
        },
        "rating": 3.5,
        "reviews_count": 5871,
        "sponsored": false
      },
      {
        "position": 16,
        "title": "Kestrel wireless earbuds Max",
        "url": "https://www.amazon.com/dp/B00000UQ2W",
        "price": {
          "amount": 211.98,
          "currency": "USD"
        },
        "rating": 3.5,
        "reviews_count": 8861,
        "sponsored": false
      }
    ]
  }
}

Coming soon: GET /v1/structured/google/search answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

A Google results page (SERP): organic results, related searches, People Also Ask. GET /v1/structured/google/search

Parameter

Type

Default

Description

query (required)

string

—

The search terms.

page

integer

1

Results page, 1–100.

country

string

us

Two-letter country to search from (Google gl).

language

string

en

Interface language (Google hl), e.g. en, de, pt-BR.

num

integer

10

Results per page, 10–100.

cURL

curl "https://api.scrapely.dev/v1/structured/google/search?query=web+scraping+api&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "google/search",
  "url": "https://www.google.com/search?q=web%20scraping%20api&gl=us&hl=en&num=10&start=0",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "query": "web scraping api",
    "page": 1,
    "total_results": 628276816,
    "results": [
      {
        "position": 1,
        "title": "web scraping api — Complete guide",
        "url": "https://docs.example-544.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 2,
        "title": "web scraping api — Documentation",
        "url": "https://blog.example-960.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 3,
        "title": "web scraping api — Best options in 2026",
        "url": "https://www.example-475.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 4,
        "title": "web scraping api — How it works",
        "url": "https://learn.example-929.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 5,
        "title": "web scraping api — Pricing compared",
        "url": "https://docs.example-476.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 6,
        "title": "web scraping api — Complete guide",
        "url": "https://blog.example-683.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 7,
        "title": "web scraping api — Documentation",
        "url": "https://www.example-575.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 8,
        "title": "web scraping api — Best options in 2026",
        "url": "https://learn.example-519.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 9,
        "title": "web scraping api — How it works",
        "url": "https://docs.example-627.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 10,
        "title": "web scraping api — Pricing compared",
        "url": "https://blog.example-380.com/web-scraping-api",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      }
    ],
    "organic_results": [
      {
        "position": 1,
        "title": "web scraping api — Complete guide",
        "url": "https://docs.example-544.com/web-scraping-api",
        "displayed_url": "docs.example-544.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 2,
        "title": "web scraping api — Documentation",
        "url": "https://blog.example-960.com/web-scraping-api",
        "displayed_url": "blog.example-960.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 3,
        "title": "web scraping api — Best options in 2026",
        "url": "https://www.example-475.com/web-scraping-api",
        "displayed_url": "www.example-475.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 4,
        "title": "web scraping api — How it works",
        "url": "https://learn.example-929.com/web-scraping-api",
        "displayed_url": "learn.example-929.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 5,
        "title": "web scraping api — Pricing compared",
        "url": "https://docs.example-476.com/web-scraping-api",
        "displayed_url": "docs.example-476.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 6,
        "title": "web scraping api — Complete guide",
        "url": "https://blog.example-683.com/web-scraping-api",
        "displayed_url": "blog.example-683.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 7,
        "title": "web scraping api — Documentation",
        "url": "https://www.example-575.com/web-scraping-api",
        "displayed_url": "www.example-575.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 8,
        "title": "web scraping api — Best options in 2026",
        "url": "https://learn.example-519.com/web-scraping-api",
        "displayed_url": "learn.example-519.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 9,
        "title": "web scraping api — How it works",
        "url": "https://docs.example-627.com/web-scraping-api",
        "displayed_url": "docs.example-627.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      },
      {
        "position": 10,
        "title": "web scraping api — Pricing compared",
        "url": "https://blog.example-380.com/web-scraping-api",
        "displayed_url": "blog.example-380.com › web",
        "snippet": "Everything you need to know about web scraping api. Updated regularly with examples and comparisons."
      }
    ],
    "related_searches": [
      "web scraping api free",
      "web scraping api vs",
      "best web scraping api",
      "web scraping api api"
    ],
    "people_also_ask": [
      {
        "question": "What is web scraping api?",
        "snippet": "web scraping api is …"
      },
      {
        "question": "Is web scraping api legal?",
        "snippet": "It depends on the data and the jurisdiction …"
      }
    ]
  }
}

Google Shopping

Coming soon: GET /v1/structured/google/shopping answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

Shopping results for a query: product, price, merchant, rating. GET /v1/structured/google/shopping

Parameter

Type

Default

Description

query (required)

string

—

The search terms.

country

string

us

Two-letter country to shop from.

cURL

curl "https://api.scrapely.dev/v1/structured/google/shopping?query=espresso+machine" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "google/shopping",
  "url": "https://www.google.com/search?q=espresso%20machine&tbm=shop&gl=us",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "query": "espresso machine",
    "results": [
      {
        "position": 1,
        "title": "Lumen espresso machine",
        "url": "https://shop.example-794.com/p/1",
        "price": {
          "amount": 80.34,
          "currency": "USD"
        },
        "merchant": "Newegg",
        "rating": null,
        "reviews_count": 2907
      },
      {
        "position": 2,
        "title": "Halcyon espresso machine",
        "url": "https://shop.example-951.com/p/2",
        "price": {
          "amount": 372.56,
          "currency": "USD"
        },
        "merchant": "Best Buy",
        "rating": 4.2,
        "reviews_count": 1893
      },
      {
        "position": 3,
        "title": "Kestrel espresso machine",
        "url": "https://shop.example-830.com/p/3",
        "price": {
          "amount": 243.26,
          "currency": "USD"
        },
        "merchant": "Target",
        "rating": 4.3,
        "reviews_count": 3263
      },
      {
        "position": 4,
        "title": "Vertex espresso machine",
        "url": "https://shop.example-776.com/p/4",
        "price": {
          "amount": 299.66,
          "currency": "USD"
        },
        "merchant": "Target",
        "rating": 4.3,
        "reviews_count": 894
      },
      {
        "position": 5,
        "title": "Kestrel espresso machine",
        "url": "https://shop.example-176.com/p/5",
        "price": {
          "amount": 198.47,
          "currency": "USD"
        },
        "merchant": "Newegg",
        "rating": 4.9,
        "reviews_count": 3932
      },
      {
        "position": 6,
        "title": "Northwind espresso machine",
        "url": "https://shop.example-106.com/p/6",
        "price": {
          "amount": 283.16,
          "currency": "USD"
        },
        "merchant": "Walmart",
        "rating": 4.6,
        "reviews_count": 3133
      },
      {
        "position": 7,
        "title": "Lumen espresso machine",
        "url": "https://shop.example-929.com/p/7",
        "price": {
          "amount": 346.18,
          "currency": "USD"
        },
        "merchant": "Walmart",
        "rating": 4.9,
        "reviews_count": 29
      },
      {
        "position": 8,
        "title": "Northwind espresso machine",
        "url": "https://shop.example-748.com/p/8",
        "price": {
          "amount": 31.68,
          "currency": "USD"
        },
        "merchant": "Newegg",
        "rating": 4.3,
        "reviews_count": 3269
      },
      {
        "position": 9,
        "title": "Kestrel espresso machine",
        "url": "https://shop.example-372.com/p/9",
        "price": {
          "amount": 37.92,
          "currency": "USD"
        },
        "merchant": "Newegg",
        "rating": null,
        "reviews_count": 914
      },
      {
        "position": 10,
        "title": "Kestrel espresso machine",
        "url": "https://shop.example-683.com/p/10",
        "price": {
          "amount": 290.42,
          "currency": "USD"
        },
        "merchant": "Walmart",
        "rating": 4.2,
        "reviews_count": 3900
      },
      {
        "position": 11,
        "title": "Kestrel espresso machine",
        "url": "https://shop.example-519.com/p/11",
        "price": {
          "amount": 343.78,
          "currency": "USD"
        },
        "merchant": "Target",
        "rating": 3.6,
        "reviews_count": 1235
      },
      {
        "position": 12,
        "title": "Lumen espresso machine",
        "url": "https://shop.example-319.com/p/12",
        "price": {
          "amount": 74.38,
          "currency": "USD"
        },
        "merchant": "Newegg",
        "rating": 4.3,
        "reviews_count": 715
      }
    ]
  }
}

Walmart product

Coming soon: GET /v1/structured/walmart/product answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

A Walmart product page by item id: title, price, rating, availability, specifications. GET /v1/structured/walmart/product

Parameter

Type

Default

Description

product_id (required)

string

—

Numeric Walmart item id, from walmart.com/ip/<slug>/<id>.

cURL

curl "https://api.scrapely.dev/v1/structured/walmart/product?product_id=5129928603" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "walmart/product",
  "url": "https://www.walmart.com/ip/5129928603",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "product_id": "5129928603",
    "url": "https://www.walmart.com/ip/5129928603",
    "title": "Kestrel Mechanical Keyboard",
    "brand": "Halcyon",
    "price": {
      "amount": 230.55,
      "currency": "USD"
    },
    "rating": 3.7,
    "reviews_count": 627,
    "availability": "in_stock",
    "images": [
      "https://i5.walmartimages.com/asr/5129928603-1.jpeg",
      "https://i5.walmartimages.com/asr/5129928603-2.jpeg"
    ],
    "specifications": [
      {
        "name": "Color",
        "value": "Black"
      },
      {
        "name": "Weight",
        "value": "1.5 lb"
      }
    ]
  }
}

Coming soon: GET /v1/structured/walmart/search answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

Walmart search results for a query. GET /v1/structured/walmart/search

Parameter

Type

Default

Description

query (required)

string

—

The search terms.

page

integer

1

Results page, 1–100.

cURL

curl "https://api.scrapely.dev/v1/structured/walmart/search?query=air+fryer" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "walmart/search",
  "url": "https://www.walmart.com/search?q=air%20fryer&page=1",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "query": "air fryer",
    "page": 1,
    "total_results": 3359,
    "results": [
      {
        "position": 1,
        "title": "Lumen air fryer",
        "url": "https://www.walmart.com/ip/8045225622",
        "price": {
          "amount": 129.56,
          "currency": "USD"
        },
        "rating": 4.5,
        "reviews_count": 2514,
        "sponsored": true
      },
      {
        "position": 2,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/4466777026",
        "price": {
          "amount": 94.39,
          "currency": "USD"
        },
        "rating": 3.7,
        "reviews_count": 1536,
        "sponsored": false
      },
      {
        "position": 3,
        "title": "Vertex air fryer",
        "url": "https://www.walmart.com/ip/3569186156",
        "price": {
          "amount": 142.07,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 1243,
        "sponsored": false
      },
      {
        "position": 4,
        "title": "Acme air fryer",
        "url": "https://www.walmart.com/ip/4611374128",
        "price": {
          "amount": 17.56,
          "currency": "USD"
        },
        "rating": 4.2,
        "reviews_count": 1891,
        "sponsored": false
      },
      {
        "position": 5,
        "title": "Acme air fryer",
        "url": "https://www.walmart.com/ip/2995209375",
        "price": {
          "amount": 181.83,
          "currency": "USD"
        },
        "rating": 3.7,
        "reviews_count": 2047,
        "sponsored": false
      },
      {
        "position": 6,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/6934482999",
        "price": {
          "amount": 41.83,
          "currency": "USD"
        },
        "rating": 3.6,
        "reviews_count": 85,
        "sponsored": false
      },
      {
        "position": 7,
        "title": "Lumen air fryer",
        "url": "https://www.walmart.com/ip/3809265060",
        "price": {
          "amount": 183.03,
          "currency": "USD"
        },
        "rating": 3.9,
        "reviews_count": 1601,
        "sponsored": false
      },
      {
        "position": 8,
        "title": "Vertex air fryer",
        "url": "https://www.walmart.com/ip/2108344133",
        "price": {
          "amount": 140,
          "currency": "USD"
        },
        "rating": 4,
        "reviews_count": 497,
        "sponsored": true
      },
      {
        "position": 9,
        "title": "Kestrel air fryer",
        "url": "https://www.walmart.com/ip/7895441966",
        "price": {
          "amount": 171.21,
          "currency": "USD"
        },
        "rating": 4.7,
        "reviews_count": 2066,
        "sponsored": false
      },
      {
        "position": 10,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/5365418747",
        "price": {
          "amount": 204.94,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 481,
        "sponsored": false
      },
      {
        "position": 11,
        "title": "Vertex air fryer",
        "url": "https://www.walmart.com/ip/2007886907",
        "price": {
          "amount": 214.55,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 394,
        "sponsored": false
      },
      {
        "position": 12,
        "title": "Lumen air fryer",
        "url": "https://www.walmart.com/ip/4419973853",
        "price": {
          "amount": 62.2,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 1078,
        "sponsored": false
      },
      {
        "position": 13,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/1384467476",
        "price": {
          "amount": 176.98,
          "currency": "USD"
        },
        "rating": 4.1,
        "reviews_count": 2735,
        "sponsored": false
      },
      {
        "position": 14,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/1819965206",
        "price": {
          "amount": 203.24,
          "currency": "USD"
        },
        "rating": 4.5,
        "reviews_count": 1113,
        "sponsored": false
      },
      {
        "position": 15,
        "title": "Vertex air fryer",
        "url": "https://www.walmart.com/ip/8628134964",
        "price": {
          "amount": 226.71,
          "currency": "USD"
        },
        "rating": 3.7,
        "reviews_count": 1415,
        "sponsored": true
      },
      {
        "position": 16,
        "title": "Northwind air fryer",
        "url": "https://www.walmart.com/ip/1445038389",
        "price": {
          "amount": 109.54,
          "currency": "USD"
        },
        "rating": 4.2,
        "reviews_count": 1724,
        "sponsored": false
      },
      {
        "position": 17,
        "title": "Northwind air fryer",
        "url": "https://www.walmart.com/ip/1427276523",
        "price": {
          "amount": 199.29,
          "currency": "USD"
        },
        "rating": 4.9,
        "reviews_count": 1724,
        "sponsored": false
      },
      {
        "position": 18,
        "title": "Lumen air fryer",
        "url": "https://www.walmart.com/ip/7280530899",
        "price": {
          "amount": 206.65,
          "currency": "USD"
        },
        "rating": 4.2,
        "reviews_count": 1780,
        "sponsored": false
      },
      {
        "position": 19,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/7194158172",
        "price": {
          "amount": 158.74,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews_count": 2619,
        "sponsored": false
      },
      {
        "position": 20,
        "title": "Halcyon air fryer",
        "url": "https://www.walmart.com/ip/5823920506",
        "price": {
          "amount": 71.47,
          "currency": "USD"
        },
        "rating": 4,
        "reviews_count": 904,
        "sponsored": false
      }
    ]
  }
}

eBay listing

Coming soon: GET /v1/structured/ebay/product answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

An eBay listing by item id: price, shipping, condition, seller feedback, auction state. GET /v1/structured/ebay/product

Parameter

Type

Default

Description

item_id (required)

string

—

Numeric eBay item id, from ebay.com/itm/<id>.

country

enum

us

Marketplace / locale to query.

cURL

curl "https://api.scrapely.dev/v1/structured/ebay/product?item_id=305512345678&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "ebay/product",
  "url": "https://www.ebay.com/itm/305512345678",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "item_id": "305512345678",
    "url": "https://www.ebay.com/itm/305512345678",
    "title": "Northwind Air Fryer",
    "condition": "refurbished",
    "price": {
      "amount": 665.93,
      "currency": "USD"
    },
    "shipping": {
      "amount": 0,
      "currency": "USD"
    },
    "seller": {
      "name": "seller_72734",
      "feedback_score": 8495,
      "positive_percent": 96.3
    },
    "bids": null,
    "ends_at": null,
    "images": [
      "https://i.ebayimg.com/images/g/305512345678/s-l1600.jpg"
    ]
  }
}

Coming soon: GET /v1/structured/ebay/search answers 501 NOT_IMPLEMENTED with "coming_soon": true until it launches, and charges nothing. The parameters below are the planned interface.

eBay search results for a query. GET /v1/structured/ebay/search

Parameter

Type

Default

Description

query (required)

string

—

The search terms.

page

integer

1

Results page, 1–100.

country

enum

us

Marketplace / locale to query.

cURL

curl "https://api.scrapely.dev/v1/structured/ebay/search?query=mechanical+keyboard" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "endpoint": "ebay/search",
  "url": "https://www.ebay.com/sch/i.html?_nkw=mechanical%20keyboard&_pgn=1",
  "credits": 5,
  "duration_ms": 1840,
  "data": {
    "query": "mechanical keyboard",
    "page": 1,
    "total_results": 15903,
    "results": [
      {
        "position": 1,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/224565157853",
        "price": {
          "amount": 256.61,
          "currency": "USD"
        }
      },
      {
        "position": 2,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/120951240696",
        "price": {
          "amount": 284.29,
          "currency": "USD"
        }
      },
      {
        "position": 3,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/180183295719",
        "price": {
          "amount": 58.39,
          "currency": "USD"
        }
      },
      {
        "position": 4,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/782158941216",
        "price": {
          "amount": 251.8,
          "currency": "USD"
        }
      },
      {
        "position": 5,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/215781723521",
        "price": {
          "amount": 103.77,
          "currency": "USD"
        }
      },
      {
        "position": 6,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/199574215151",
        "price": {
          "amount": 474.73,
          "currency": "USD"
        }
      },
      {
        "position": 7,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/344979101233",
        "price": {
          "amount": 268.48,
          "currency": "USD"
        }
      },
      {
        "position": 8,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/521430285461",
        "price": {
          "amount": 397.35,
          "currency": "USD"
        }
      },
      {
        "position": 9,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/308057296834",
        "price": {
          "amount": 475.69,
          "currency": "USD"
        }
      },
      {
        "position": 10,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/873917528428",
        "price": {
          "amount": 290.55,
          "currency": "USD"
        }
      },
      {
        "position": 11,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/366932089440",
        "price": {
          "amount": 80.68,
          "currency": "USD"
        }
      },
      {
        "position": 12,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/461232301779",
        "price": {
          "amount": 242.79,
          "currency": "USD"
        }
      },
      {
        "position": 13,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/763405122421",
        "price": {
          "amount": 127.41,
          "currency": "USD"
        }
      },
      {
        "position": 14,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/560157022811",
        "price": {
          "amount": 411.32,
          "currency": "USD"
        }
      },
      {
        "position": 15,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/753197106532",
        "price": {
          "amount": 439.49,
          "currency": "USD"
        }
      },
      {
        "position": 16,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/421671496517",
        "price": {
          "amount": 25.74,
          "currency": "USD"
        }
      },
      {
        "position": 17,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/728262273035",
        "price": {
          "amount": 33.37,
          "currency": "USD"
        }
      },
      {
        "position": 18,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/692095493711",
        "price": {
          "amount": 214.55,
          "currency": "USD"
        }
      },
      {
        "position": 19,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/739884076826",
        "price": {
          "amount": 22.78,
          "currency": "USD"
        }
      },
      {
        "position": 20,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/166262579150",
        "price": {
          "amount": 443.1,
          "currency": "USD"
        }
      },
      {
        "position": 21,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/135052149556",
        "price": {
          "amount": 355.93,
          "currency": "USD"
        }
      },
      {
        "position": 22,
        "title": "mechanical keyboard — New",
        "url": "https://www.ebay.com/itm/685225189663",
        "price": {
          "amount": 343.25,
          "currency": "USD"
        }
      },
      {
        "position": 23,
        "title": "mechanical keyboard — Used",
        "url": "https://www.ebay.com/itm/818620502762",
        "price": {
          "amount": 239.83,
          "currency": "USD"
        }
      },
      {
        "position": 24,
        "title": "mechanical keyboard — Open box",
        "url": "https://www.ebay.com/itm/790990962274",
        "price": {
          "amount": 450.51,
          "currency": "USD"
        }
      }
    ]
  }
}
Updated