Shop APIshop.app ↗
Access Shop.app products, merchant profiles, categories, and homepage featured items via 7 structured endpoints. Prices, ratings, reviews, and pagination included.
What is the Shop API?
The Shop.app API exposes 7 endpoints covering products, merchants, categories, and homepage featured items from shop.app. Starting with get_homepage_featured_products, you can retrieve up to 10 featured products with IDs and slugs, then drill into full pricing, images, and merchant details via get_product_details. Merchant discovery flows through search autocomplete and category browsing, each returning structured data ready to query without any pre-configuration.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5dd62abe-8dc5-4896-99ae-78ddfd844b61/get_homepage_featured_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieves featured products from the shop.app homepage hero carousel. Returns up to 10 products across categories (general, beauty, fashion). No parameters needed. Each product includes basic info suitable for drilling into details via get_product_details.
No input parameters required.
{
"type": "object",
"fields": {
"products": "array of product objects with id, title, slug, category, image_url, rating, review_count"
},
"sample": {
"data": {
"products": [
{
"id": "4131300606034",
"slug": "cookware-set",
"title": "Cookware Set",
"rating": 4.8,
"category": "general",
"image_url": "https://cdn.shopify.com/s/files/1/0258/6273/3906/files/Cookware_Set.jpg",
"review_count": 39164
}
]
},
"status": "success"
}
}About the Shop API
Product and Merchant Data
The get_product_details endpoint returns a full product record given a product_id and product_slug (both available from get_homepage_featured_products or get_merchant_products). The response includes price, original_price (when a discount exists), an images array, rating, review_count, and a merchant object with id, name, and handle. The get_merchant_products endpoint accepts a broker_id and supports cursor-based pagination via after and first parameters, returning nodes with per-product reviewAnalytics, price, originalPrice, and images, alongside hasNextPage and endCursor for walking through large catalogs.
Merchant Discovery
get_merchant_info takes a merchant handle and returns the full shop profile: websiteUrl, shopifyId, defaultHandle, and productReviewAnalytics with totalProductReviews and averageRating. To find handles without prior knowledge, get_search_autocomplete accepts a query prefix and returns both text completions and matching shop objects carrying id, name, handle, and rating — making it a practical entry point for any merchant lookup flow.
Category and Filtered Search
list_categories returns all top-level shop.app categories, each with a Shopify GID, display name, hasChildren flag, and a path array of GIDs for building hierarchical navigation. search_merchants_by_category accepts a category slug (such as women, beauty, or fitness-nutrition) and supports filtering by min_rating, max_rating, min_reviews, and max_reviews, returning paginated merchant records with id, name, handle, rating, review_count, and website_url. Page-level controls include page, page_size, and the has_next_page boolean.
The Shop API is a managed, monitored endpoint for shop.app — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when shop.app changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official shop.app API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate discounted products by comparing
priceandoriginal_pricefields fromget_product_details - Build a merchant directory filtered by minimum rating using
search_merchants_by_categorywithmin_rating - Track homepage promotion trends by periodically calling
get_homepage_featured_productsand logging category distribution - Enumerate a merchant's full product catalog using
get_merchant_productswith cursor pagination viaendCursor - Resolve merchant handles from brand name fragments using
get_search_autocompletebefore fetching full profiles - Construct a category tree for navigation by combining
list_categoriesGID paths withsearch_merchants_by_categoryresults - Compare review volume and average ratings across merchants in a category using
productReviewAnalyticsfromget_merchant_info
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Shop.app have an official developer API?+
What does `get_search_autocomplete` return, and how is it useful for other endpoints?+
get_search_autocomplete returns two types of suggestions for a given query prefix: plain text query completions (type query) and matched merchant records (type shop) carrying id, name, handle, and rating. The id maps directly to broker_id in get_merchant_products, and handle feeds into get_merchant_info, making autocomplete a practical discovery layer when you don't already have merchant identifiers.Does `get_merchant_info` return individual product reviews or review text?+
get_merchant_info exposes aggregate productReviewAnalytics containing totalProductReviews and averageRating at the merchant level. Per-product review summaries (rating, review_count) are available from get_product_details and get_merchant_products, but review body text is not currently exposed. You can fork this API on Parse and revise it to add an endpoint targeting individual review content.Are product inventory levels or stock status available?+
price, original_price), images, ratings, and merchant info, but do not include inventory counts, in-stock flags, or variant-level availability. You can fork this API on Parse and revise it to add inventory or variant data if that field becomes accessible.How does pagination work in `get_merchant_products`?+
first (1–100) to set page size and omit after on the first request. The response includes endCursor and hasNextPage; on subsequent requests, pass the previous endCursor value as after to retrieve the next page. totalCount in every response reflects the full product count for that merchant.