Shopping

Each parser reads one kind of page and returns the site’s own data. Send the page’s URL to scrape with a json format that names the parser. The data comes back in data.json.

curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.amazon.com/s?k=laptop&low-price=300&high-price=900&s=review-rank","formats":[{"type":"json","parser":"amazon-search"}]}'

const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.amazon.com/s?k=laptop&low-price=300&high-price=900&s=review-rank",
    formats: [{ type: "json", parser: "amazon-search" }],
  }),
});
console.log(await response.json());

import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.amazon.com/s?k=laptop&low-price=300&high-price=900&s=review-rank",
        "formats": [{"type": "json", "parser": "amazon-search"}],
    },
)
print(response.json())

Send a parser’s options in the same format, like {"type": "json", "parser": "amazon-search", "options": {...}}. See Parsers for how they work.

Parser	Reads	Price
`amazon-search`	An Amazon search page with a search word or a department, like amazon.com/s?k=laptop.	1 credit per call.
`amazon-product`	An Amazon product page, like amazon.com/dp/`<ASIN>`.	1 credit per call.
`amazon-reviews`	An Amazon product page.	1 credit per call.
`amazon-bestsellers`	An Amazon Best Sellers category page, like amazon.com/Best-Sellers-Electronics/zgbs/electronics.	1 credit per call.
`tiktok-shop`	A TikTok Shop search page (/k/), store page (/store/) or product page (/pdp/).	1 credit per call.
`ebay-search`	An ebay.com search page, like ebay.com/sch/i.html?_nkw=iphone.	1 credit per call.
`ebay-item`	An eBay item page, like ebay.com/itm/`<item id>`.	1 credit per call.
`facebook-marketplace`	A Facebook Marketplace search page with a city and a query, like facebook.com/marketplace/austin/search?query=bike.	1 credit per call.
`craigslist-search`	A Craigslist search page with a five-digit US ZIP code in postal, like sfbay.craigslist.org/search/sss?query=bike&postal=94103.	1 credit per 10 listings.
`trustpilot-search`	A Trustpilot search page, like trustpilot.com/search?query=stripe.	1 credit per call.
`trustpilot-company`	A Trustpilot company page, like trustpilot.com/review/stripe.com.	1 credit per call.
`trustpilot-reviews`	A Trustpilot company page, like trustpilot.com/review/stripe.com.	1 credit per call.

amazon-search

An Amazon search page with a search word or a department, like amazon.com/s?k=laptop.

Example page: https://www.amazon.com/s?k=laptop&low-price=300&high-price=900&s=review-rank
Returns: A list of products: results, cursor, page, total.
Options: category, minRating, brand, page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "B0HGMH4B7S",
      "url": "https://www.amazon.com/dp/B0HGMH4B7S",
      "title": "HP 14 inch Laptop, Intel Processor N150, 4GB RAM 384GB Storage(UFS+SD Card)",
      "brand": null,
      "description": null,
      "price": {
        "amount": 319,
        "currency": "USD"
      },
      "originalPrice": null,
      "rating": 5,
      "reviewCount": 54,
      "availability": null,
      "images": [
        "https://m.media-amazon.com/images/I/71uaMcxitqL._AC_UY218_.jpg"
      ],
      "categories": [],
      "seller": null,
      "boughtPastMonth": 200,
      "isSponsored": false
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 18815
}

amazon-product

An Amazon product page, like amazon.com/dp/<ASIN>.

Example page: https://www.amazon.com/dp/B0CX23V2ZK
Returns: One product: id, url, title, brand, description, price, originalPrice, rating, reviewCount, availability, images, categories, seller.
Options: country (ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted).
Price: 1 credit per call.

Example response

{
  "id": "B0CX23V2ZK",
  "url": "https://www.amazon.com/dp/B0CX23V2ZK",
  "title": "Apple 2024 MacBook Air 13-inch Laptop with M3 chip: Built for Apple Intelligence, 13.6-inch Liquid Retina Display, 8GB…",
  "brand": "Apple",
  "description": null,
  "price": null,
  "originalPrice": null,
  "rating": 4.8,
  "reviewCount": 1081,
  "availability": "Currently unavailable.",
  "images": [
    "https://m.media-amazon.com/images/I/71-D1xCuVwL._AC_SL1500_.jpg",
    "https://m.media-amazon.com/images/I/61LbQpnFNvL._AC_SL1500_.jpg",
    "https://m.media-amazon.com/images/I/61S2t5yhVSL._AC_SL1500_.jpg"
  ],
  "categories": [],
  "seller": null,
  "bullets": [
    "LEAN. MEAN. M3 MACHINE - With a powerful 8-core CPU and 10-core GPU, the blazing-fast MacBook Air with M3 chip is a…",
    "BUILT FOR APPLE INTELLIGENCE-Apple Intelligence is the personal intelligence system that helps you write, express…",
    "PORTABLE DESIGN - Lightweight and under half an inch thin, so you can take MacBook Air anywhere you go."
  ],
  "variants": [],
  "sellerShipsFrom": null,
  "bestSellersRank": [],
  "specs": [
    {
      "name": "Brand",
      "value": "Apple"
    }
  ],
  "topReviews": []
}

amazon-reviews

An Amazon product page. Marketplaces outside the US, like amazon.in/dp/<ASIN>, show their top reviews without sign-in, up to 13 for the product page. Amazon US shows reviews only after sign-in, so an amazon.com page returns reviews for few products.

Example page: https://www.amazon.in/dp/B0CHX1W1XY
Returns: A list of reviews: results, cursor, page, total.
Options: country (ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted), rating (Only reviews with this star rating), verifiedOnly (Only reviews from verified purchases), cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "R3CGMF6T85GZEN",
      "url": null,
      "author": {
        "id": null,
        "name": "Kaleem",
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "rating": 5,
      "title": "Great performance",
      "text": "I’m really happy with this phone. The performance is smooth, and the display quality is impressive.",
      "publishedAt": "2026-10-30T00:00:00.000Z",
      "likes": 0,
      "response": null,
      "subject": {
        "id": "B0CHX1W1XY",
        "name": null,
        "url": null
      },
      "isVerified": true,
      "variant": null,
      "imageUrls": []
    }
  ],
  "cursor": null,
  "page": null,
  "total": null
}

amazon-bestsellers

An Amazon Best Sellers category page, like amazon.com/Best-Sellers-Electronics/zgbs/electronics.

Example page: https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics
Returns: A list of products: results, cursor, page, total.
Options: page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "B08JHCVHTY",
      "url": "https://www.amazon.com/dp/B08JHCVHTY",
      "title": "blink plus plan with monthly auto-renewal",
      "brand": null,
      "description": null,
      "price": {
        "amount": 11.99,
        "currency": "USD"
      },
      "originalPrice": null,
      "rating": 4.4,
      "reviewCount": 281734,
      "availability": null,
      "images": [
        "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png"
      ],
      "categories": [],
      "seller": null,
      "rank": 1
    }
  ],
  "cursor": null,
  "page": 1,
  "total": null,
  "category": "Electronics"
}

tiktok-shop

A TikTok Shop search page (/k/), store page (/store/) or product page (/pdp/). Send options view reviews on a product page for its reviews.

Example page: https://shop.tiktok.com/us/k/gummies
Returns: A list of products: results, cursor, page, total.
Options: cursor (The cursor from the previous response. Send it as is).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "1729432589178278226",
      "url": "https://shop.tiktok.com/us/pdp/gummies-combo-pack-by-bearvana-womens-fitness-aid-with-herbs/1729432589178278226",
      "title": "BEARVANA Women's 16-Herb Wellness Gummies Combo Pack | Vitamins A C E and B6 | Daily Gummies Worth the Hype | Berry…",
      "brand": null,
      "description": null,
      "price": {
        "amount": 59.99,
        "currency": "USD"
      },
      "originalPrice": null,
      "rating": 4.5,
      "reviewCount": 39182,
      "availability": null,
      "images": [
        "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/f77b653568a4438680b65f19bd753731~tplv-fhlh96ny…"
      ],
      "categories": [],
      "seller": {
        "id": "7495523339641194834",
        "name": "BEARVANA",
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "sold": 404309
    }
  ],
  "cursor": "30::1729432589178278226,1732759068244480363,1732805322000928869,1732766556619117362,1729890372836496007,1730206447762903669,1732757985036964658,1731659207048...",
  "page": null,
  "total": null
}

ebay-search

An ebay.com search page, like ebay.com/sch/i.html?_nkw=iphone.

Example page: https://www.ebay.com/sch/i.html?_nkw=iphone+15&_udlo=300&_udhi=800&_sop=15
Returns: A list of products: results, cursor, page, total.
Options: condition, auctionsOnly (Only auctions. With sort endingSoonest this lists auctions about to end; ebay.item then returns what each one sold for), page (Page number, starting at 1).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "168683336290",
      "url": "https://www.ebay.com/itm/168683336290",
      "title": "Apple iPhone 15 128GB (BLACK)",
      "brand": null,
      "description": null,
      "price": {
        "amount": 300,
        "currency": "USD"
      },
      "originalPrice": null,
      "rating": null,
      "reviewCount": null,
      "availability": null,
      "images": [
        "https://i.ebayimg.com/images/g/GhMAAeSwWxpqpV1Z/s-l500.jpg"
      ],
      "categories": [],
      "seller": {
        "id": null,
        "name": "brittanhick166",
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "priceMax": null,
      "isPriceHidden": false,
      "shippingCost": null,
      "isPickupOnly": true,
      "totalPrice": {
        "amount": 300,
        "currency": "USD"
      },
      "condition": "Pre-Owned",
      "isAuction": false,
      "bids": null,
      "timeLeft": null,
      "hasBestOffer": true,
      "itemLocation": "United States",
      "quantitySold": null,
      "watchers": 70,
      "sellerFeedbackPercent": null,
      "sellerFeedbackScore": 0
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 4800
}

ebay-item

An eBay item page, like ebay.com/itm/<item id>.

Example page: https://www.ebay.com/itm/266625967665
Returns: One product: id, url, title, brand, description, price, originalPrice, rating, reviewCount, availability, images, categories, seller.
Price: 1 credit per call.

Example response

{
  "id": "266625967665",
  "url": "https://www.ebay.com/itm/266625967665",
  "title": "Nintendo Switch 64GB OLED White Console 1 Day Ship Excellent Refurbished",
  "brand": "Nintendo",
  "description": "?? For U.S. Buyers:\n\nNo import duties will be charged. You can purchase with peace of mind.\n\n? For Buyers Outside the…",
  "price": {
    "amount": 296,
    "currency": "USD"
  },
  "originalPrice": {
    "amount": 370,
    "currency": "USD"
  },
  "rating": null,
  "reviewCount": null,
  "availability": "available",
  "images": [
    "https://i.ebayimg.com/images/g/O14AAOSwOz9mVJtw/s-l1600.png",
    "https://i.ebayimg.com/images/g/c~YAAOSwI71lqz3d/s-l1600.jpg",
    "https://i.ebayimg.com/images/g/7awAAOSwfV1lqon7/s-l1600.jpg"
  ],
  "categories": [
    "Electronics",
    "Video Games & Consoles",
    "Video Game Consoles"
  ],
  "seller": {
    "id": null,
    "name": "Samurai_Game.Shop",
    "handle": null,
    "url": null,
    "avatarUrl": null
  },
  "model": "Nintendo Switch (OLED Model)",
  "specifics": [
    {
      "name": "Seller Notes",
      "value": "“Excellent - Refurbished: The item is in like-new condition, backed by a one year warranty. It has been professionally…"
    }
  ],
  "condition": "Excellent - Refurbished",
  "isAuction": false,
  "bids": null,
  "isEnded": false,
  "endedAt": null,
  "isSold": false,
  "soldPrice": null,
  "soldAt": null,
  "isAvailable": true,
  "quantityAvailable": 5,
  "quantitySold": 160,
  "sellerFeedbackScore": 9472,
  "sellerFeedbackPercent": 99.9,
  "shippingCost": {
    "amount": 0,
    "currency": "USD"
  },
  "shippingPostalCode": "08232",
  "itemLocation": "Gifu, Japan",
  "returnsAccepted": true,
  "returnDays": 30,
  "listedAt": "2024-01-20T03:27:03.000Z"
}

facebook-marketplace

A Facebook Marketplace search page with a city and a query, like facebook.com/marketplace/austin/search?query=bike.

Example page: https://www.facebook.com/marketplace/austin/search?query=bike
Returns: A list of listings: results, cursor, page, total.
Options: minPrice (Lowest price in local currency (e.g., 50)), maxPrice (Highest price in local currency (e.g., 500)), sort (Sort order (newest, priceLow or priceHigh), relevance by default).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "4592280847709289",
      "url": "https://www.facebook.com/marketplace/item/4592280847709289/",
      "title": "Bike",
      "description": null,
      "price": {
        "amount": 85,
        "currency": "USD"
      },
      "pricePeriod": "sale",
      "status": "available",
      "address": "Austin, TX",
      "location": null,
      "bedrooms": null,
      "bathrooms": null,
      "area": null,
      "propertyType": null,
      "rating": null,
      "reviewCount": null,
      "images": [
        "https://scontent-iad3-2.xx.fbcdn.net/v/t39.84726-6/886726471_1489389276412115_3383755310775348626_n.jpg?stp=c0.43.261.2…"
      ],
      "host": null,
      "priceText": "$85",
      "city": "Austin",
      "state": "TX",
      "publishedAt": "2026-11-04T00:16:04.000Z",
      "isPending": false
    }
  ],
  "cursor": null,
  "page": null,
  "total": null,
  "location": "Austin, Texas",
  "latitude": 30.2677,
  "longitude": -97.7475
}

craigslist-search

A Craigslist search page with a five-digit US ZIP code in postal, like sfbay.craigslist.org/search/sss?query=bike&postal=94103.

Example page: https://sfbay.craigslist.org/search/sss?query=bike&postal=94103&search_distance=25
Returns: A list of listings: results, cursor, page, total.
Options: minPrice (Lowest price in US dollars (e.g., 50)), maxPrice (Highest price in US dollars (e.g., 500)), limit (Return at most this many listings. You pay 1 credit per 10 returned).
Price: 1 credit per 10 listings.

Example response

{
  "results": [
    {
      "id": "7995382659",
      "url": "https://www.craigslist.org/view/d/san-francisco-2013-bmw-k1600/9GFQHZkctQ4nJBUeAfZHQh",
      "title": "2013 BMW K1600",
      "description": null,
      "price": {
        "amount": 6500,
        "currency": "USD"
      },
      "pricePeriod": null,
      "status": null,
      "address": "noe valley",
      "location": {
        "latitude": 37.745,
        "longitude": -122.4383
      },
      "bedrooms": null,
      "bathrooms": null,
      "area": null,
      "propertyType": null,
      "rating": null,
      "reviewCount": null,
      "images": [
        "https://images.craigslist.org/01212_dEwA5HIEfjT_1320MM_600x450.jpg"
      ],
      "host": null,
      "publishedAt": "2026-11-04T23:12:28.000Z"
    }
  ],
  "cursor": null,
  "page": null,
  "total": 5031
}

trustpilot-search

A Trustpilot search page, like trustpilot.com/search?query=stripe.

Example page: https://www.trustpilot.com/search?query=payments
Returns: A list of products: results, cursor, page, total.
Options: page (Page number, starting at 1. Trustpilot shows 10 pages of 10 companies without an account, so one search reaches at most 100 companies even when total is larger. Make the query more specific to reach the rest).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "50489e6800006400051ae0d6",
      "url": "https://www.trustpilot.com/review/stripe.com",
      "title": "https://stripe.com/payments/checkout",
      "brand": null,
      "description": null,
      "price": null,
      "originalPrice": null,
      "rating": 1.6,
      "reviewCount": 17569,
      "availability": null,
      "images": [],
      "categories": [
        "Payment Service"
      ],
      "seller": null,
      "companyDomain": "stripe.com",
      "website": "https://stripe.com",
      "stars": 1.5,
      "addressStreet": "510 Townsend Street",
      "addressCity": "San Francisco",
      "addressPostalCode": "94103",
      "addressCountry": "United States"
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 273
}

trustpilot-company

A Trustpilot company page, like trustpilot.com/review/stripe.com.

Example page: https://www.trustpilot.com/review/stripe.com
Returns: One product: id, url, title, brand, description, price, originalPrice, rating, reviewCount, availability, images, categories, seller.
Price: 1 credit per call.

Example response

{
  "id": "50489e6800006400051ae0d6",
  "url": "https://www.trustpilot.com/review/stripe.com",
  "title": "https://stripe.com/payments/checkout",
  "brand": null,
  "description": "Millions of businesses of all sizes-from startups to large enterprises-use Stripe’s software and APIs to accept…",
  "price": null,
  "originalPrice": null,
  "rating": 1.6,
  "reviewCount": 17568,
  "availability": null,
  "images": [],
  "categories": [
    "Payment Service"
  ],
  "seller": null,
  "companyDomain": "stripe.com",
  "website": "https://stripe.com",
  "stars": 1.5,
  "addressStreet": "510 Townsend Street",
  "addressCity": "San Francisco",
  "addressPostalCode": "94103",
  "addressCountry": "United States",
  "ratingsOne": 9141,
  "ratingsTwo": 513,
  "ratingsThree": 468,
  "ratingsFour": 725,
  "ratingsFive": 6721,
  "isClaimed": true,
  "isClosed": false,
  "email": "https://support.stripe.com/contact",
  "phone": null,
  "negativeReviewsRepliedPercent": 100,
  "averageDaysToReply": 1.6
}

trustpilot-reviews

A Trustpilot company page, like trustpilot.com/review/stripe.com.

Example page: https://www.trustpilot.com/review/stripe.com?stars=1&stars=2&languages=en
Returns: A list of reviews: results, cursor, page, total.
Options: datePublished (Only reviews published in the last 30 days, 3, 6 or 12 months), verifiedOnly (Only reviews Trustpilot marks as verified), search (Only reviews that mention this word or phrase), page (Page number, starting at 1. Trustpilot shows 10 pages of 20 reviews without an account; narrow with ratings, language, datePublished or search to reach older reviews).
Price: 1 credit per call.

Example response

{
  "results": [
    {
      "id": "6aeb69e52f5f72549e50ecc2",
      "url": "https://www.trustpilot.com/reviews/6aeb69e52f5f72549e50ecc2",
      "author": {
        "id": null,
        "name": "Bystrík Královič",
        "handle": null,
        "url": null,
        "avatarUrl": null
      },
      "rating": 1,
      "title": "Automatically created Stripe Link account storing personal and payment information",
      "text": "I made a one time payment on a website that uses Stripe, and during the checkout process, I was apparently signed up…",
      "publishedAt": "2026-11-04T19:22:45.000Z",
      "likes": null,
      "response": null,
      "subject": {
        "id": "stripe.com",
        "name": "https://stripe.com/payments/checkout",
        "url": "https://www.trustpilot.com/review/stripe.com"
      },
      "language": "en",
      "experiencedDate": "2026-11-04T00:00:00.000Z",
      "isVerified": false,
      "authorCountry": "SK"
    }
  ],
  "cursor": null,
  "page": 1,
  "total": 7505
}

Get started

Parsers

Guides

Plans and billing

amazon-search

amazon-product

amazon-reviews

amazon-bestsellers

tiktok-shop

ebay-search

ebay-item

facebook-marketplace

craigslist-search

trustpilot-search

trustpilot-company

trustpilot-reviews

​amazon-search

​amazon-product

​amazon-reviews

​amazon-bestsellers

​tiktok-shop

​ebay-search

​ebay-item

​facebook-marketplace

​craigslist-search

​trustpilot-search

​trustpilot-company

​trustpilot-reviews

amazon-search

amazon-product

amazon-reviews

amazon-bestsellers

tiktok-shop

ebay-search

ebay-item

facebook-marketplace

craigslist-search

trustpilot-search

trustpilot-company

trustpilot-reviews