Structured data

Popular page types as typed JSON: Reddit posts, search and comments, and Bing and DuckDuckGo results.

Endpoints

How it works, when to use what, and what it costs: Reddit and web search. Base URL, authentication and errors: Overview.

GET /v1/structured

List structured endpoints.

Every structured endpoint with its parameters and status (live or coming_soon).

Request

curl "https://api.scrapelyserp.com/v1/structured" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

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

const res = await fetch('https://api.scrapelyserp.com/v1/structured', {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  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": "reddit/posts",
      "site": "reddit",
      "name": "Reddit posts",
      "description": "The posts of a subreddit, newest or top first.",
      "status": "live",
      "coming_soon": false,
      "url": "https://api.scrapelyserp.com/api/v1/structured/reddit/posts",
      "params": [
        {
          "name": "subreddit",
          "type": "string",
          "required": true,
          "default": null,
          "values": null,
          "description": "The subreddit, with or without r/."
        }
      ],
      "example": {
        "subreddit": "webscraping",
        "sort": "new"
      }
    }
  ]
}

Responses

Response fields

GET /v1/structured/amazon/search

Amazon search.

Amazon search results for a query, in Amazon's order: ASIN, title, price and list price, rating, review count, image and whether the placement is sponsored. 16 to 60 per page (Amazon picks the layout for each query); send next_page back as page for more, up to page 20. sort is best_match, best_selling, price_low, price_high, rating or newest. Sponsored placements are included and marked sponsored: true. price is the price the result shows (null when it shows none) and list_price the struck-through list or typical price when there is one. brand and in_stock are always null: search does not carry them, ask POST /v1/products. Each id (and asin) is what POST /v1/products takes. A keyword that matches nothing is an empty list (total_results 0), and so is a page past the last one; an answer we cannot read is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list. Amazon US.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/amazon/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=wireless earbuds"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/amazon/search",
    headers=HEADERS,
    params={"query": "wireless earbuds"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/amazon/search?${new URLSearchParams({ query: 'wireless earbuds' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "amazon/search",
  "url": "https://www.amazon.com/s?k=wireless%20earbuds",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "wireless earbuds",
    "page": 1,
    "total_results": 29095,
    "next_page": 2,
    "results": [
      {
        "position": 3,
        "id": "B0BQPNMXQV",
        "asin": "B0BQPNMXQV",
        "title": "JBL Vibe Beam - True Wireless Earbuds - Black",
        "url": "https://www.amazon.com/dp/B0BQPNMXQV",
        "brand": null,
        "image": "https://m.media-amazon.com/images/I/41+1Csr1pSL._AC_UY218_.jpg",
        "price": {
          "amount": 29.95,
          "currency": "USD"
        },
        "list_price": {
          "amount": 49.95,
          "currency": "USD"
        },
        "rating": 4.2,
        "reviews_count": 41401,
        "in_stock": null,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/amazon/image-search

Amazon image search.

Amazon products that look like a photo: the objects found in it, ranked ASIN matches with a score each, and title, price, list price, rating, reviews, stock, brand and variations for the top matches. Send an image URL, up to 10 image URLs, or the image itself in base64 with POST. JPEG and PNG.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/amazon/image-search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "image_url=https://m.media-amazon.com/images/I/61PQSiTkywL.jpg"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/amazon/image-search",
    headers=HEADERS,
    params={"image_url": "https://m.media-amazon.com/images/I/61PQSiTkywL.jpg"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/amazon/image-search?${new URLSearchParams({ image_url: 'https://m.media-amazon.com/images/I/61PQSiTkywL.jpg' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "amazon/image-search",
  "url": "https://www.amazon.com/",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "results": [
      {
        "image_url": "https://m.media-amazon.com/images/I/61PQSiTkywL.jpg",
        "status": "ok",
        "objects": [
          {
            "label": "footwear",
            "category": "shoes",
            "score": 0.9655,
            "box": {
              "x": 7,
              "y": 158,
              "width": 787,
              "height": 369,
              "image_width": 800,
              "image_height": 571
            }
          }
        ],
        "matches": [
          {
            "rank": 1,
            "asin": "B08Q9SDCFJ",
            "score": 0.9158,
            "kind": "visual",
            "object": 0
          },
          {
            "rank": 2,
            "asin": "B08QB1QMJ5",
            "score": 0.8803,
            "kind": "visual",
            "object": 0
          }
        ],
        "products": [
          {
            "asin": "B08Q9SDCFJ",
            "title": "Nike Women's Dunk Low Sneaker",
            "url": "https://www.amazon.com/dp/B08Q9SDCFJ",
            "brand": "Nike",
            "image": "https://m.media-amazon.com/images/I/61PQSiTkywL.jpg",
            "price": {
              "amount": 99.95,
              "currency": "USD"
            },
            "list_price": {
              "amount": 120,
              "currency": "USD"
            },
            "rating": 4.6,
            "reviews_count": 3720,
            "availability": "in_stock",
            "in_stock": true,
            "variations": ["B0BKR4NWW6", "B0DC6Z3CXX"],
            "colors": []
          }
        ],
        "queries": []
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/amazon/deals

Amazon deals.

Today's Amazon deals, in Amazon's order: ASIN, title, deal price and list price, percent off, deal type and badge, end time for lightning deals, rating, reviews, brand and variation count. Filter by department, brand, rating or Prime Exclusive; up to 100 deals per page.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/amazon/deals" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d department=electronics \
  -d limit=20

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/amazon/deals",
    headers=HEADERS,
    params={"department": "electronics", "limit": "20"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/amazon/deals?${new URLSearchParams({ department: 'electronics', limit: '20' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "amazon/deals",
  "url": "https://www.amazon.com/deals",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "page": 1,
    "limit": 2,
    "next_page": 2,
    "deals": [
      {
        "position": 1,
        "asin": "B0F7Z4QZTT",
        "title": "Amazon Fire TV Stick 4K Plus with AI-powered Fire TV Search, Wi-Fi 6",
        "url": "https://www.amazon.com/dp/B0F7Z4QZTT",
        "image": "https://m.media-amazon.com/images/I/51WtNy0OxLL.jpg",
        "brand": "Amazon",
        "brand_id": "323125",
        "price": {
          "amount": 39.99,
          "currency": "USD"
        },
        "list_price": {
          "amount": 69.99,
          "currency": "USD"
        },
        "percent_off": 43,
        "deal_type": "best_deal",
        "badge": "Limited time deal",
        "deal_state": "available",
        "ends_at": null,
        "claimed_percent": null,
        "rating": 4.6,
        "reviews_count": 116169,
        "variations": 1
      },
      {
        "position": 2,
        "asin": "B0C1NQZDYH",
        "title": "BEDLORE Waterproof Mattress Protector, King Size Mattress Pad",
        "url": "https://www.amazon.com/dp/B0C1NQZDYH",
        "image": "https://m.media-amazon.com/images/I/81X+MBrUg+L.jpg",
        "brand": "BEDLORE",
        "brand_id": "4742140",
        "price": {
          "amount": 26.38,
          "currency": "USD"
        },
        "list_price": {
          "amount": 32.99,
          "currency": "USD"
        },
        "percent_off": 20,
        "deal_type": "lightning_deal",
        "badge": "Ends in",
        "deal_state": "available",
        "ends_at": "2026-11-06T05:50:00.000Z",
        "claimed_percent": 32,
        "rating": 4.6,
        "reviews_count": 29101,
        "variations": 61
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/walmart/search

Walmart search.

Walmart search results for a query, in the site's order: item id, title, brand, price and list price, rating, review count, stock and image. 25 per page; send next_page back as page for more. Each id is what POST /v1/products takes for Walmart.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/walmart/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=air fryer"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/walmart/search",
    headers=HEADERS,
    params={"query": "air fryer"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/walmart/search?${new URLSearchParams({ query: 'air fryer' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "walmart/search",
  "url": "https://www.walmart.com/search?q=air%20fryer",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "air fryer",
    "page": 1,
    "total_results": 2498,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "16101019328",
        "title": "Beautiful by Drew Barrymore 6 qt Air Fryer with TurboCrisp Technology, White Icing",
        "url": "https://www.walmart.com/ip/16101019328",
        "brand": "Beautiful",
        "image": null,
        "price": {
          "amount": 59,
          "currency": "USD"
        },
        "list_price": {
          "amount": 69,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews_count": 20544,
        "in_stock": true,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/target/search

Target search.

Target search results for a query, in the site's order: TCIN, title, brand, price and regular price, rating, review count and image. 24 per page; send next_page back as page for more. Each id is what POST /v1/products takes for Target.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/target/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=air fryer"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/target/search",
    headers=HEADERS,
    params={"query": "air fryer"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/target/search?${new URLSearchParams({ query: 'air fryer' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "target/search",
  "url": "https://www.target.com/s?searchTerm=air%20fryer",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "air fryer",
    "page": 1,
    "total_results": 272,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "89110863",
        "title": "Gourmia 6qt Digital Window Air Fryer with 12 Presets & Guided Cooking Black",
        "url": "https://www.target.com/p/-/A-89110863",
        "brand": "Gourmia",
        "image": null,
        "price": {
          "amount": 44.99,
          "currency": "USD"
        },
        "list_price": {
          "amount": 69.99,
          "currency": "USD"
        },
        "rating": 4.07,
        "reviews_count": 2309,
        "in_stock": null,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/bestbuy/search

Best Buy search.

Best Buy search results for a query, in the site's order: SKU, title, brand, price and regular price, rating, review count and image. 50 per page; send next_page back as page for more. Each id is what POST /v1/products takes for Best Buy.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/bestbuy/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=air fryer"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/bestbuy/search",
    headers=HEADERS,
    params={"query": "air fryer"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/bestbuy/search?${new URLSearchParams({ query: 'air fryer' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "bestbuy/search",
  "url": "https://www.bestbuy.com/site/searchpage.jsp?st=air%20fryer",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "air fryer",
    "page": 1,
    "total_results": 66,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "6583884",
        "title": "bella PRO - SmartCrisp 8-qt. Touchscreen Air Fryer - Stainless Steel",
        "url": "https://www.bestbuy.com/site/6583884.p?skuId=6583884",
        "brand": "bella PRO",
        "image": null,
        "price": {
          "amount": 59.99,
          "currency": "USD"
        },
        "list_price": {
          "amount": 129.99,
          "currency": "USD"
        },
        "rating": 4.6,
        "reviews_count": 1840,
        "in_stock": null,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/petsmart/search

PetSmart search.

PetSmart search results for a query, in the site's order: product id, title, brand, lowest and highest price, rating, review count, stock and image. 40 per page; send next_page back as page for more. Each id is what POST /v1/products takes for PetSmart.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/petsmart/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=dog food"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/petsmart/search",
    headers=HEADERS,
    params={"query": "dog food"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/petsmart/search?${new URLSearchParams({ query: 'dog food' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "petsmart/search",
  "url": "https://www.petsmart.com/search?q=dog%20food",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "dog food",
    "page": 1,
    "total_results": 4034,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "36648",
        "title": "Purina Pro Plan Sensitive Skin and Stomach Dry Dog Food Adult Salmon & Rice Formula Digestive Health",
        "url": "https://www.petsmart.com/dog/food/dry-food/purina-pro-plan-sensitive-skin-and-stomach-dry-dog-food-adult-salmon-and-rice-formula-digestive-health-36648.html",
        "brand": "Purina Pro Plan",
        "image": null,
        "price": {
          "amount": 20.68,
          "currency": "USD"
        },
        "price_max": {
          "amount": 94.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.5,
        "reviews_count": 9248,
        "in_stock": true,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/samsclub/search

Sam's Club search.

Sam's Club search results for a query, in the site's order: item id, title, brand (often null), price and regular price, rating, review count, stock and image. about 45 per page; send next_page back as page for more. Each id is what POST /v1/products takes for Sam's Club. Sponsored placements are left out. Sam's Club often refuses a request: a call can answer 502 TARGET_FAILED (not charged), so retry it, and a keyword that lands on a category page instead of results is a failure, not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/samsclub/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=vitamins

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/samsclub/search",
    headers=HEADERS,
    params={"query": "vitamins"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/samsclub/search?${new URLSearchParams({ query: 'vitamins' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "samsclub/search",
  "url": "https://www.samsclub.com/s/vitamins",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "vitamins",
    "page": 1,
    "total_results": 256,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "13899862238",
        "title": "Member's Mark Advanced Women's 50+ Multivitamin Tablets, 275 ct.",
        "url": "https://www.samsclub.com/ip/Member-s-Mark-Advanced-Women-s-50-Multivitamin-Tablets-275-ct/13899862238",
        "brand": null,
        "image": null,
        "price": {
          "amount": 13.34,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.5,
        "reviews_count": 859,
        "in_stock": true,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/walgreens/search

Walgreens search.

Walgreens search results for a query, in the site's order: product id, title, brand, price and regular price, rating, review count, stock and image. rating is in half stars (4.0, 4.5), not exact. Up to 72 per call, one page only (no page or sort); total_results counts all matches. in_stock is null when Walgreens does not say. Each id is what POST /v1/products takes for Walgreens. A keyword that lands on a service page instead of products (such as 'prescription') is a failure, not an empty list, and so is a block: a call can answer 502 TARGET_FAILED (not charged), so retry it. Prescription items are never returned.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/walgreens/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=shampoo

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/walgreens/search",
    headers=HEADERS,
    params={"query": "shampoo"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/walgreens/search?${new URLSearchParams({ query: 'shampoo' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "walgreens/search",
  "url": "https://www.walgreens.com/q/shampoo",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "shampoo",
    "page": 1,
    "total_results": 526,
    "next_page": null,
    "results": [
      {
        "position": 1,
        "id": "300452904",
        "title": "Walgreens Shiny & Smooth Shampoo",
        "url": "https://www.walgreens.com/store/c/walgreens-shiny-%26-smooth-shampoo/ID=300452904-product",
        "brand": "Walgreens",
        "image": null,
        "price": {
          "amount": 3.74,
          "currency": "USD"
        },
        "list_price": {
          "amount": 4.99,
          "currency": "USD"
        },
        "rating": 4,
        "reviews_count": 90,
        "in_stock": true
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/cvs/search

CVS search.

CVS search results for a query, in the site's order: product id, title, brand, price (the lowest, with price_max when the product has variants at different prices) and regular price, rating, review count and image. 40 per page; send next_page back as page for more. sort is best_match or price_low. in_stock is always null: search does not report availability. Sponsored placements and prescription items are left out. Each id is what POST /v1/products takes for CVS. CVS often refuses a request: a call can answer 502 TARGET_FAILED (not charged), so retry it, and an answer that is not clearly a list of products or a count of zero is a failure, not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/cvs/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=shampoo

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/cvs/search",
    headers=HEADERS,
    params={"query": "shampoo"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/cvs/search?${new URLSearchParams({ query: 'shampoo' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "cvs/search",
  "url": "https://www.cvs.com/search?searchTerm=shampoo",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "shampoo",
    "page": 1,
    "total_results": 497,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "949346",
        "title": "Carol's Daughter Lisa's Kitchen Scalp Detox Cleansing Nectar, 8 OZ",
        "url": "https://www.cvs.com/shop/carol-s-daughter-lisa-s-kitchen-scalp-detox-cleansing-nectar-8-oz-prodid-949346",
        "brand": "Carol's Daughter",
        "image": null,
        "price": {
          "amount": 12.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.74,
        "reviews_count": 153,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/bjs/search

BJ's search.

BJ's search results for a query, in the site's order: item number, title, brand (null when BJ's gives none), price_range (low and high), rating, review count and image. 100 per page; send next_page back as page for more. sort is best_match, rating or newest. price and list_price are always null: BJ's data gives a price range, not the price at a given club, and the current club price is not available. in_stock is always null: search does not report availability. Each id is what POST /v1/products takes for BJ's. A keyword that matches nothing still returns BJ's nearest items, and an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list. Prescription items are never returned.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/bjs/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=coffee

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/bjs/search",
    headers=HEADERS,
    params={"query": "coffee"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/bjs/search?${new URLSearchParams({ query: 'coffee' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "bjs/search",
  "url": "https://www.bjs.com/search/coffee",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "coffee",
    "page": 1,
    "total_results": 219,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "328157",
        "title": "Maxwell House Medium Roast Original Ground Coffee, 43.1 oz.",
        "url": "https://www.bjs.com/product/maxwell-house-medium-roast-original-ground-coffee-431-oz/3000000000005070289/",
        "brand": null,
        "image": "https://bjs.scene7.com/is/image/bjs/328157",
        "price": null,
        "list_price": null,
        "price_range": {
          "min": {
            "amount": 15.29,
            "currency": "USD"
          },
          "max": {
            "amount": 22.99,
            "currency": "USD"
          }
        },
        "rating": 5,
        "reviews_count": 1344,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/stockx/search

StockX search.

StockX search results for a query, in the site's order: slug, title, brand, lowest ask (as price), whether anything is on sale, and image. 40 per page; send next_page back as page for more. Each id is what POST /v1/products takes for StockX.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/stockx/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=dunk low"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/stockx/search",
    headers=HEADERS,
    params={"query": "dunk low"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/stockx/search?${new URLSearchParams({ query: 'dunk low' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "stockx/search",
  "url": "https://stockx.com/search?s=dunk%20low",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "dunk low",
    "page": 1,
    "total_results": 1000,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "nike-dunk-low-retro-white-black-2021",
        "title": "Nike Dunk Low Retro White Black Panda",
        "url": "https://stockx.com/nike-dunk-low-retro-white-black-2021",
        "brand": "Nike",
        "image": null,
        "price": {
          "amount": 59,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": true,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/goat/search

GOAT search.

GOAT search results for a query, in the site's order: slug, title, brand, lowest price, retail price, stock and image. 24 per page; send next_page back as page for more. Each id is what POST /v1/products takes for GOAT.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/goat/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=dunk low"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/goat/search",
    headers=HEADERS,
    params={"query": "dunk low"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/goat/search?${new URLSearchParams({ query: 'dunk low' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "goat/search",
  "url": "https://www.goat.com/search?query=dunk%20low",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "dunk low",
    "page": 1,
    "total_results": 3239,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "dunk-low-black-white-dd1391-100",
        "title": "Nike Dunk Low 'Black White'",
        "url": "https://www.goat.com/sneakers/dunk-low-black-white-dd1391-100",
        "brand": "Nike",
        "image": null,
        "price": {
          "amount": 59,
          "currency": "USD"
        },
        "list_price": {
          "amount": 100,
          "currency": "USD"
        },
        "rating": null,
        "reviews_count": null,
        "in_stock": true,
        "sponsored": false
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/tcgplayer/search

TCGplayer search.

TCGplayer search results for a query, in the site's order: product id, title, market price (as price), whether any listing exists, and image. 50 per page; send next_page back as page for more. sort is best_match, best_selling, price_low, price_high (both on the market price), listing_low (cheapest listing first), newest or name; product_line narrows to one game (pokemon, yugioh, star-wars-unlimited). price is TCGplayer's market price, a figure from recent sales for the product, and null when it has none; list_price, rating and reviews_count are always null. in_stock is true when at least one listing exists. Each id is what POST /v1/products takes for TCGplayer. An answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/tcgplayer/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=charizard

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/tcgplayer/search",
    headers=HEADERS,
    params={"query": "charizard"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/tcgplayer/search?${new URLSearchParams({ query: 'charizard' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "tcgplayer/search",
  "url": "https://www.tcgplayer.com/search/all/product?q=charizard",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "charizard",
    "page": 1,
    "total_results": 382,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "662182",
        "title": "Mega Charizard X ex - 013/094",
        "url": "https://www.tcgplayer.com/product/662182/pokemon-me02-phantasmal-flames-mega-charizard-x-ex-013-094",
        "brand": null,
        "image": "https://product-images.tcgplayer.com/fit-in/437x608/662182.jpg",
        "price": {
          "amount": 3.55,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": true
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/staples/search

Staples search.

Staples search results for a query, in the site's order: item id, title, brand, price (for one unit), link and image. 100 per page; send next_page back as page for more, up to page 100 (10,000 results). sort is best_match, price_low or price_high. list_price, rating, reviews_count and in_stock are always null: search does not carry them, ask POST /v1/products. A set of options (an id starting SS) has price null. Each id is what POST /v1/products takes for Staples. A keyword that matches nothing still returns Staples' nearest item (one result), and an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/staples/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=copy paper"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/staples/search",
    headers=HEADERS,
    params={"query": "copy paper"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/staples/search?${new URLSearchParams({ query: 'copy paper' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "staples/search",
  "url": "https://www.staples.com/copy%20paper/directory_copy%20paper",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "copy paper",
    "page": 1,
    "total_results": 11201,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "122374",
        "title": "Hammermill Copy Plus 8.5\" x 11\" Copy Paper, 20 lbs., 92 Brightness, 5000 Sheets/Carton (105007)",
        "url": "https://www.staples.com/product_122374",
        "brand": "Hammermill",
        "image": "https://www.staples-3p.com/s7/is/image/Staples/0A9DEFAA-5A39-42C6-938F42EAB5C0ACCF",
        "price": {
          "amount": 49.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/kohls/search

Kohl's search.

Kohl's search results for a query, a category, or both, in the site's order: product id, title, price, regular price, rating, review count, link and image. 120 per page; send next_page back as page for more. sort is best_match, newest, price_low, price_high or rating. category is a Kohl's category value (the CN= part of a Kohl's catalog link, Gender:Mens+Category:Bottoms+Department:Clothing); with a category the query is optional and narrows within it. price is the regular price, or the sale price when marked down; it is never the 20% coupon price Kohl's pages lead with. A product with options at different prices has price null and a price_range (low and high); list_price is the regular price of a product on sale at one price. Sponsored placements are left out. brand is always null and in_stock is always null: Kohl's search carries neither. Each id is what POST /v1/products takes for Kohl's. A keyword that matches nothing still returns Kohl's closest items (33 for a nonsense word), and a category Kohl's does not recognize, a page past the last one, or an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list. A request with neither query nor category is refused.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/kohls/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=mens jeans"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/kohls/search",
    headers=HEADERS,
    params={"query": "mens jeans"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/kohls/search?${new URLSearchParams({ query: 'mens jeans' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "kohls/search",
  "url": "https://www.kohls.com/search.jsp?search=mens%20jeans",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "mens jeans",
    "page": 1,
    "total_results": 2198,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "7431597",
        "title": "Sonoma Goods For Life Hygro Performance Bath Towel, Bath Sheet, Hand Towel or Washcloth",
        "url": "https://www.kohls.com/product/prd-7431597/sonoma-goods-for-life-hygro-performance-bath-towel-bath-sheet-hand-towel-or-washcloth.jsp",
        "brand": null,
        "image": "https://media.kohlsimg.com/is/image/kohls/7431597_Blush?wid=180&hei=180&op_sharpen=1",
        "price": null,
        "price_range": {
          "min": {
            "amount": 7.99,
            "currency": "USD"
          },
          "max": {
            "amount": 49.99,
            "currency": "USD"
          }
        },
        "list_price": null,
        "rating": 4.4,
        "reviews_count": 14485,
        "in_stock": null
      },
      {
        "position": 2,
        "id": "8363284",
        "title": "Men's Vintage America Straight Fit Denim Jeans",
        "url": "https://www.kohls.com/product/prd-8363284/mens-vintage-america-straight-fit-denim-jeans.jsp",
        "brand": null,
        "image": "https://media.kohlsimg.com/is/image/kohls/8363284_Liberty_Wash?wid=180&hei=180&op_sharpen=1",
        "price": {
          "amount": 26.4,
          "currency": "USD"
        },
        "price_range": null,
        "list_price": {
          "amount": 44,
          "currency": "USD"
        },
        "rating": 5,
        "reviews_count": 5,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/officedepot/search

Office Depot search.

Office Depot search results for a query, in the site's order: sku, title, brand, price (for one unit), rating, review count, link and image. 24 per page; send next_page back as page for more. sort is best_match, price_low, price_high or rating (Office Depot's Customer Rating order, which favours products with many good reviews over a high average). list_price and in_stock are always null: Office Depot's search results show a wrong list price and a wrong stock status, so ask POST /v1/products for the skus you want. rating and reviews_count are null with no reviews. Sponsored placements are left out. Each id is what POST /v1/products takes for Office Depot. A keyword that matches nothing still returns 200 of Office Depot's products (24 a page, total_results exactly 200) and nothing in the answer marks it: a real search reports its true total (84, 487…), so a total_results of 200 whose titles do not contain your words means no match. An empty list means Office Depot says there are no matches; any other unclear answer is a failure (502 TARGET_FAILED, not charged, retry it).

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/officedepot/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=printer paper"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/officedepot/search",
    headers=HEADERS,
    params={"query": "printer paper"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/officedepot/search?${new URLSearchParams({ query: 'printer paper' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "officedepot/search",
  "url": "https://www.officedepot.com/a/search/?q=printer%20paper",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "printer paper",
    "page": 1,
    "total_results": 487,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "301742",
        "title": "JAM Paper® Color Multi-Use Printer & Copy Paper, Brown Kraft, Letter (8.5\" x 11\"), 50 Sheets Per Pack, 28 Lb",
        "url": "https://www.officedepot.com/a/products/301742/JAM-Paper-Color-Multi-Use-Printer/",
        "brand": "JAM Paper",
        "image": "https://media.officedepot.com/images/t_large%2Cf_auto/products/301742/1.jpg",
        "price": {
          "amount": 29.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.67,
        "reviews_count": 3,
        "in_stock": null
      },
      {
        "position": 2,
        "id": "196517",
        "title": "Boise® X-9® Multi-Use Printer & Copy Paper, 10 Reams, White, Letter (8.5\" x 11\"), 5000 Sheets Per Case, 20 Lb, 92 Brightness",
        "url": "https://www.officedepot.com/a/products/196517/Boise-X-9-Multi-Use-Printer/",
        "brand": "BOISE",
        "image": "https://media.officedepot.com/images/t_large%2Cf_auto/products/196517/1.jpg",
        "price": {
          "amount": 48.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.68,
        "reviews_count": 20060,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/ikea/search

IKEA search.

IKEA search results for a query or a category, in the site's order: item number, title, price, regular price, rating, review count, link and image. 100 per page; send next_page back as page for more. sort is best_match, price_low, price_high, newest or rating. category is an IKEA category key (fu003 is sofas & sectionals); with a category the query is optional and narrows within it. price is IKEA's public price. A product that shows an IKEA Family (member) price has that member price in POST /v1/products, never here; list_price is the earlier or regular price of a marked-down product. brand is always null and in_stock is always null: search carries neither (ask POST /v1/products for online availability). Each id is what POST /v1/products takes for IKEA. A keyword that matches nothing returns zero results (200, total_results 0). A category key IKEA does not know, a page past the last one, or an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list. A request with neither query nor category is refused.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/ikea/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=desk

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/ikea/search",
    headers=HEADERS,
    params={"query": "desk"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/ikea/search?${new URLSearchParams({ query: 'desk' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "ikea/search",
  "url": "https://www.ikea.com/us/en/search/?q=desk",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "desk",
    "page": 1,
    "total_results": 187,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "10514155",
        "title": "IDANÄS Desk, white, 59 7/8x27 1/2 \"",
        "url": "https://www.ikea.com/us/en/p/idanaes-desk-white-10514155/",
        "brand": null,
        "image": "https://www.ikea.com/us/en/images/products/idanaes-desk-white__1159443_pe888489_s5.jpg",
        "price": {
          "amount": 449,
          "currency": "USD"
        },
        "list_price": {
          "amount": 599,
          "currency": "USD"
        },
        "rating": 4.3,
        "reviews_count": 31,
        "in_stock": null
      },
      {
        "position": 2,
        "id": "60609679",
        "title": "GULLABERG L-shaped desk, drop file storage/white, 61x61x29 1/2 \"",
        "url": "https://www.ikea.com/us/en/p/gullaberg-l-shaped-desk-drop-file-storage-white-60609679/",
        "brand": null,
        "image": "https://www.ikea.com/us/en/images/products/gullaberg-l-shaped-desk-drop-file-storage-white__1536835_pe1016995_s5.jpg",
        "price": {
          "amount": 399.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/poshmark/search

Poshmark search.

Poshmark listings for a query, in the site's order: listing id, title, brand, price, original price, size, condition, stock per size, seller, department, category, likes, link and image. Up to 100 per page for available listings (48 for status=sold); page on with cursor: send next_cursor back as cursor. sort is best_match, newest (just listed), price_low or price_high; condition=new_with_tags and min_price / max_price (dollars) narrow the listings. status is available (the default) or sold; sold listings cost about 5 times as much per listing and take sort and condition but not the price filters. About 5,000 listings are reachable for one query, however many total_results says (it stops at 10,000). price is the seller's listing price, never including fees or shipping; list_price is the original price the seller gave, null when none. rating and reviews_count are always null: listings have none. in_stock is true for an available listing and false for a sold one; poshmark.sizes has the quantity per size. poshmark.condition is new_with_tags or Poshmark's own code, and null when the seller set none. Each id is what POST /v1/products takes for Poshmark. A keyword that matches nothing still returns loose matches (99 for a nonsense word), and an answer that is not clearly a list of listings or a total of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/poshmark/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=levis jeans"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/poshmark/search",
    headers=HEADERS,
    params={"query": "levis jeans"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/poshmark/search?${new URLSearchParams({ query: 'levis jeans' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "poshmark/search",
  "url": "https://poshmark.com/search?query=levis%20jeans",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "levis jeans",
    "page": 1,
    "total_results": 10000,
    "next_page": null,
    "next_cursor": "ENC_eyJtYXhfaWRzIjpbMTAxLDEsMV0sIm1heF9pZF9zY2hlbWUiOiJvcmciLCJwYWdlX251bSI6MiwicGFnZV9ncm91cF9pZCI6IjZhZWNiODc5OGY5ZDNlOGQ3MDdjMmQ5NyJ9",
    "results": [
      {
        "position": 1,
        "id": "6aecb847f09fc893a4990038",
        "title": "NWT signature Levi strauss Gold totally shaping pull on jeans",
        "url": "https://poshmark.com/listing/6aecb847f09fc893a4990038",
        "brand": "signature levi strauss gold",
        "image": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/05/6aecb847f09fc893a4990038/m_6aecb84cc6a0b3f268778f5a.jpeg",
        "price": {
          "amount": 15,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": true,
        "poshmark": {
          "listingStatus": "available",
          "size": "32",
          "condition": "new_with_tags",
          "sizes": [
            {
              "size": "32",
              "available": 1,
              "sold": 0
            }
          ],
          "seller": "deedeshay0619",
          "department": "Women",
          "category": "Jeans",
          "likes": 0
        }
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/gamestop/search

GameStop search.

GameStop search results for a query, in the site's order: product id, title, brand (null when GameStop gives none), current price, link and image. 200 per page; send next_page back as page for more. sort is best_match, popular, price_low, price_high or newest. New, pre-owned, digital and refurbished copies are separate products with separate ids and prices; a row shows one of them (the best match), and POST /v1/products lists the others as gamestop.siblings. A pre-owned price can be higher than the new one: it is what GameStop's data says. list_price, rating, reviews_count and in_stock are always null: GameStop's data has no list price and no rating per product, and stock is not reported. Each id is what POST /v1/products takes for GameStop. A keyword that matches no word returns an empty list (total_results 0), not GameStop's fuzzy near-matches, and an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/gamestop/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=mario kart"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/gamestop/search",
    headers=HEADERS,
    params={"query": "mario kart"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/gamestop/search?${new URLSearchParams({ query: 'mario kart' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "gamestop/search",
  "url": "https://www.gamestop.com/search/?q=mario%20kart",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "mario",
    "page": 1,
    "total_results": 512,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "393069",
        "title": "Hallmark Super Mario PVC Figural Mini Ornament Set",
        "url": "https://www.gamestop.com/home/bedroom/decor/products/hallmark-super-mario-pvc-figural-mini-ornament-set/393069.html",
        "brand": "Hallmark",
        "image": "https://media.gamestop.com/i/gamestop/20004908/Hallmark-Super-Mario-PVC-Figural-Mini-Ornament-Set?$thumb$",
        "price": {
          "amount": 9.97,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/dicks/search

Dick's search.

Dick's Sporting Goods search results for a query, in the site's order: sku, title, brand, price, regular price, rating, review count and link. 144 per page; send next_page back as page for more. sort is best_match, price_low or price_high; brand narrows to one brand. Each result is a style shown in one colour, and its id is the sku of that colour and one size: it goes straight into POST /v1/products for Dick's, which returns that sku's price and stock. price is the sku's current price (a sale ends on a date: the price in force now), and list_price the regular price when it is marked down. in_stock is always null: search carries no stock. image is always null. The price orders follow the highest price Dick's has on file for a product, which can be a later non-sale price, so current prices are close to ordered, not exact. A keyword that matches nothing still returns Dick's closest items (2 for a nonsense word we tried) rather than an empty list; a brand that matches nothing is an empty list. A page past the last, and an answer that is not clearly a list of products or a count of zero, is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/dicks/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=running shoes"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/dicks/search",
    headers=HEADERS,
    params={"query": "running shoes"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/dicks/search?${new URLSearchParams({ query: 'running shoes' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "dicks/search",
  "url": "https://www.dickssportinggoods.com/search/SearchDisplay?searchTerm=running%20shoes",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "running shoes",
    "page": 1,
    "total_results": 719,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "28503063",
        "title": "Nike Men's Alphafly 4 Road Racing Shoes",
        "url": "https://www.dickssportinggoods.com/p/nike-mens-alphafly-4-road-racing-shoes-26nikmrunnnklphflyffe/26nikmrunnnklphflyffe",
        "brand": "Nike",
        "image": null,
        "price": {
          "amount": 279.99,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": null
      },
      {
        "position": 2,
        "id": "26285440",
        "title": "HOKA Women's Clifton 10 Running Shoes",
        "url": "https://www.dickssportinggoods.com/p/hoka-womens-clifton-10-running-shoes-25fhqwclftn10blckftw/25fhqwclftn10blckftw",
        "brand": "Hoka",
        "image": null,
        "price": {
          "amount": 124.97,
          "currency": "USD"
        },
        "list_price": {
          "amount": 154.99,
          "currency": "USD"
        },
        "rating": 4.73,
        "reviews_count": 1970,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/grailed/search

Grailed search.

Grailed listings for a query, in the site's order: listing id, title, designers (as brand), asking price, original price, size, condition, department, category, seller and seller rating, likes, listed date, link and image; for a sold listing also the sold price, sold date and shipping paid. Up to 100 per page; send next_page back as page for more. sort is best_match, newest, price_low or price_high; status is available (the default) or sold; department, condition, min_price / max_price (whole dollars, on the asking price), size and designer narrow the listings. Only the first 1,000 listings of a query can be reached (page 1 to 10), however large total_results says: narrow the query with the filters to see more. price is the asking price, on a sold listing too: what a sold listing sold for is grailed.soldPrice (it can be lower, when an offer was accepted), with grailed.soldAt. list_price is the first price in the listing's price-drop history, null when the price never dropped. rating and reviews_count are always null: listings have none (the seller's own rating is grailed.sellerRating). in_stock is true for an available listing and false for a sold one. Each id is what POST /v1/products takes for Grailed. A keyword that matches nothing is an empty list (total_results 0), and an answer that is not clearly a list of listings or a total of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/grailed/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=air jordan"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/grailed/search",
    headers=HEADERS,
    params={"query": "air jordan"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/grailed/search?${new URLSearchParams({ query: 'air jordan' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "grailed/search",
  "url": "https://www.grailed.com/shop?query=air%20jordan",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "air jordan",
    "page": 1,
    "total_results": 44619,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "111350058",
        "title": "Fragment Design x Union LA x Air Jordan 1 Retro High OG",
        "url": "https://www.grailed.com/listings/111350058",
        "brand": "Fragment Design × Jordan Brand",
        "image": "https://media-assets.grailed.com/prd/listing/temp/ee3b918ddca746e8b638acc18d2123aa",
        "price": {
          "amount": 170,
          "currency": "USD"
        },
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": true,
        "grailed": {
          "status": "available",
          "size": "11",
          "condition": "gently_used",
          "category": "footwear",
          "department": "menswear",
          "seller": "616Selects",
          "sellerRating": 5,
          "sellerRatingCount": 13,
          "likes": 8,
          "listedAt": "2026-11-04T21:13:58.022Z",
          "soldPrice": null,
          "soldAt": null,
          "soldShippingPrice": null
        }
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/macys/search

Macy's search.

Macy's search results for a keyword or a category, in the site's order: product id, title, brand, price, regular price, rating, review count, stock flag, link and image. 60 to 64 per page; send next_page back as page for more. sort is best_match, best_selling, newest, price_low, price_high or rating. category is a Macy's category id (the number after id= in a category link); send query or category, not both. price is the regular price, or the sale price when marked down; it is never a coupon price. A product with options at different prices has price null and a price_range (low and high); list_price is the regular price of a product on sale at one price. in_stock is Macy's own flag on the product, null for a collection of products. Each id is what POST /v1/products takes for Macy's. A keyword that matches nothing still returns Macy's closest items (about 60 on page 1, 97 in total for a nonsense word), and a category Macy's does not recognize, a page past the last one, or an answer that is not clearly a list of products or a count of zero is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list. A request with neither query nor category, or with both, is refused.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/macys/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=dress shirt"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/macys/search",
    headers=HEADERS,
    params={"query": "dress shirt"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/macys/search?${new URLSearchParams({ query: 'dress shirt' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "macys/search",
  "url": "https://www.macys.com/shop/featured/dress%20shirt",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "dress shirt",
    "page": 1,
    "total_results": 849,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "18618230",
        "title": "Men's Regular-Fit Heritage Oxford Shirt",
        "url": "https://www.macys.com/shop/product/tommy-hilfiger-mens-regular-fit-heritage-oxford-shirt?ID=18618230",
        "brand": "Tommy Hilfiger",
        "image": null,
        "price": null,
        "price_range": {
          "min": {
            "amount": 28.43,
            "currency": "USD"
          },
          "max": {
            "amount": 89.5,
            "currency": "USD"
          }
        },
        "list_price": null,
        "rating": 4.6,
        "reviews_count": 175,
        "in_stock": true
      },
      {
        "position": 2,
        "id": "26246806",
        "title": "1200 Thread Count Cotton Blend Watercolor Printed 4-Piece Sheet Set",
        "url": "https://www.macys.com/shop/product/macys-1200-thread-count-cotton-blend-watercolor-printed-4-piece-sheet-sets?ID=26246806",
        "brand": "Macy's",
        "image": null,
        "price": {
          "amount": 59.93,
          "currency": "USD"
        },
        "price_range": null,
        "list_price": {
          "amount": 200,
          "currency": "USD"
        },
        "rating": 4.3,
        "reviews_count": 180,
        "in_stock": true
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/sephora/search

Sephora search.

Sephora search results for a query, in the site's order: id, title, brand, price, rating, review count, image and link. 200 per page; send next_page back as page for more. sort is best_match, price_low, price_high, top_rated, best_selling or newest. Each result is a product shown in one sku, and its id is the product id with that sku (P467208:2417145): it goes straight into POST /v1/products for Sephora. A product with several sizes or shades shows one card, so price is the LOWEST price shown and price_max the highest when no sale is running; when any sku is on sale price_max is null (the card does not say which skus are), and list_price is set only when the card shows one regular and one sale price. Ask for a sku with POST /v1/products for its exact price. rating and reviews_count are Sephora's own (null when unrated). in_stock is always null: search carries no stock. A keyword that matches nothing at all is an empty list (total_results 0), but a nonsense word usually still returns Sephora's closest products. A page past the last, and an answer that is not clearly a list of products or a no-match, is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/sephora/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d query=mascara

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/sephora/search",
    headers=HEADERS,
    params={"query": "mascara"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/sephora/search?${new URLSearchParams({ query: 'mascara' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "sephora/search",
  "url": "https://www.sephora.com/search?keyword=mascara",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "mascara",
    "page": 1,
    "total_results": 196,
    "next_page": null,
    "results": [
      {
        "position": 1,
        "id": "P467208:2417145",
        "title": "Lash Idôle Lengthening & Volumizing Mascara",
        "url": "https://www.sephora.com/product/lancome-lash-idole-lash-lifting-volumizing-mascara-P467208?skuId=2417145",
        "brand": "Lancôme",
        "image": "https://www.sephora.com/productimages/sku/s2417145-main-zoom.jpg?imwidth=270",
        "price": {
          "amount": 16,
          "currency": "USD"
        },
        "price_max": {
          "amount": 30,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.5,
        "reviews_count": 10787,
        "in_stock": null
      },
      {
        "position": 2,
        "id": "P479863:2638336",
        "title": "Lash Clash Extreme Volume Mascara",
        "url": "https://www.sephora.com/product/yves-saint-laurent-lash-clash-extreme-volume-mascara-P479863?skuId=2638336",
        "brand": "Yves Saint Laurent",
        "image": "https://www.sephora.com/productimages/sku/s2638336-main-zoom.jpg?imwidth=270",
        "price": {
          "amount": 18,
          "currency": "USD"
        },
        "price_max": {
          "amount": 34,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.12,
        "reviews_count": 3607,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/newegg/search

Newegg category listing.

Newegg products listed by category, in Newegg's own order (by sales): item number, title, brand, price, list price, rating, review count, stock flag, link and image. Newegg has no keyword search here: query is refused, and no typeahead is offered. category is required and takes one of: components-storage, cpu, memory, motherboard, gpu, computer-case, power-supply, hard-drive, ssd, computer-systems, nas. 100 per page, up to page 75; send next_page back as page for more. sort is not offered. price is the price charged, after Newegg's instant rebate (the rebate is on POST /v1/products), and list_price the price before it when higher; a delisted product has no price. Marketplace sellers' offers are mixed in. rating and reviews_count are Newegg's own and null when unrated; in_stock is Newegg's online stock flag. About 4 in 100 of a category's products never appear when paging it. Each id is what POST /v1/products takes for Newegg. A page past the last, an empty answer, and an answer that is not clearly a list of products is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/newegg/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d category=cpu

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/newegg/search",
    headers=HEADERS,
    params={"category": "cpu"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/newegg/search?${new URLSearchParams({ category: 'cpu' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "newegg/search",
  "url": "https://www.newegg.com/",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "",
    "page": 1,
    "total_results": 102,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "19-113-877",
        "title": "AMD Ryzen 7 9800X3D - Ryzen 7 9000 Series",
        "url": "https://www.newegg.com/p/N82E16819113877",
        "brand": "AMD",
        "image": "https://c1.neweggimages.com/NeweggImage/ProductImageCompressAll200/19-113-877-01.png",
        "price": {
          "amount": 479,
          "currency": "USD"
        },
        "list_price": null,
        "rating": 4.8,
        "reviews_count": 745,
        "in_stock": true
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/ulta/search

Ulta Beauty search.

Ulta Beauty search results for a query, in the site's order: item id, title, brand, price, regular price, rating, review count, image and link. 64 per page; send next_page back as page for more. sort is best_match, best_selling, newest, price_low, price_high or rating. Each result is a product shown in one shade or size, and its id is the product id and that sku joined by a colon: it goes straight into POST /v1/products for Ulta, which returns that sku's price and stock. A product whose shades or sizes cost different amounts has no price and a price_range instead. list_price is the regular price of a product marked down. in_stock is always null: search carries no stock. Sponsored placements are left out. rating is a pure rating order (five stars with few reviews first), not a quality ranking. A phrase that matches nothing is an empty list, though a nonsense phrase can still return a few unrelated products. A page past the last is an empty list with the total. An answer that is not clearly a list of products or a count of none is a failure (502 TARGET_FAILED, not charged, retry it), not an empty list.

Cost: charged credits for the data it moves, like every endpoint. Also accepts POST with a JSON body.

Query parameters

Request

curl -G "https://api.scrapelyserp.com/v1/structured/ulta/search" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  --data-urlencode "query=retinol serum"

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.get(
    "https://api.scrapelyserp.com/v1/structured/ulta/search",
    headers=HEADERS,
    params={"query": "retinol serum"},
    timeout=30,
)
r.raise_for_status()
data = r.json()

const res = await fetch(`https://api.scrapelyserp.com/v1/structured/ulta/search?${new URLSearchParams({ query: 'retinol serum' })}`, {
  headers: { Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}` },
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();

Response

{
  "endpoint": "ulta/search",
  "url": "https://www.ulta.com/search?search=retinol%20serum",
  "credits": 0.000028,
  "duration_ms": 1480,
  "data": {
    "query": "retinol serum",
    "page": 1,
    "total_results": 338,
    "next_page": 2,
    "results": [
      {
        "position": 1,
        "id": "mkt77006708:77010477",
        "title": "Nightinol Cream",
        "url": "https://www.ulta.com/p/nightinol-cream-mkt77006708?sku=77010477",
        "brand": "WYLYS",
        "image": "https://media.ultainc.com/i/ulta/77010477",
        "price": {
          "amount": 215,
          "currency": "USD"
        },
        "price_range": null,
        "list_price": null,
        "rating": null,
        "reviews_count": null,
        "in_stock": null
      }
    ]
  }
}

Responses

Response fields

GET /v1/structured/whatnot/search