shop.app APIshop.app ↗
Access Shop.app products, merchant profiles, categories, reviews, and homepage featured items via 7 structured endpoints. Includes pagination and autocomplete.
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.
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_-_Cream_-_Ecomm_6a51a67e-b61c-43a8-8896-03998540d631.jpg?v=1780594899",
"review_count": 39160
}
]
},
"status": "success"
}
}About the shop.app API
The Shop.app API exposes 7 endpoints covering products, merchants, categories, and homepage featured items from shop.app. You can retrieve full product details — price, images, rating, reviews, and merchant info — via get_product_details, browse merchant catalogs with cursor-based pagination via get_merchant_products, and surface autocomplete suggestions for search queries or shops via get_search_autocomplete.
Products and Merchants
get_product_details accepts a product_id and product_slug and returns the complete product record: current price, an array of image URLs, average rating, total review count, individual review objects (each with body, rating, submitted_at, and reviewer), a description string, and a merchant object containing id, name, and handle. get_merchant_info takes a merchant handle and returns the merchant's websiteUrl, shopifyId, defaultHandle, and productReviewAnalytics — an object with totalProductReviews and averageRating.
Product Listings and Pagination
get_merchant_products fetches a paginated list of products for a given broker_id, sorted by most sales. Each node includes id, title, slug, price, originalPrice, images, and reviewAnalytics. The response provides a pageInfo object with hasNextPage and endCursor; pass endCursor back as the after parameter to advance through pages. get_fashion_products works similarly but adds granular fields per product: brand, category, sale_price, compare_at_price, currency, colors, sizes, availability, material, and product_url. It defaults to AstropheApparel (ID 9067750) when broker_id is omitted and accepts an optional query parameter to filter results within the merchant.
Discovery Endpoints
get_homepage_featured_products returns up to 10 products from the shop.app homepage hero carousel, each with id, title, slug, category, image_url, rating, and review_count — useful for trending product snapshots. list_categories returns every top-level shopping category with its name, Shopify GID id, hasChildren flag, and path array of GIDs. get_search_autocomplete accepts a query prefix and returns an array of suggestions typed as either 'query' or 'shop'; shop suggestions include id, name, handle, and rating.
- Build a price-comparison tool using
price,originalPrice, andcompare_at_pricefields from product endpoints. - Aggregate merchant reputation scores by pulling
averageRatingandtotalProductReviewsfromget_merchant_info. - Populate a fashion catalog with color, size, availability, and material data from
get_fashion_products. - Implement a search-as-you-type feature using shop and query suggestions from
get_search_autocomplete. - Track which products appear in the shop.app homepage carousel over time via
get_homepage_featured_products. - Crawl a merchant's full product catalog with cursor pagination using the
after/endCursorpattern inget_merchant_products. - Display structured review feeds — body text, rating, and submission date — from
reviewsinget_product_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. 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_fashion_products return that get_merchant_products doesn't?+
get_fashion_products returns additional apparel-specific fields per product: brand, category, sale_price, compare_at_price, currency, colors, sizes, availability, material, and a direct product_url. get_merchant_products returns a broader product set across any merchant type but omits those fashion-specific attributes.How does pagination work across the product listing endpoints?+
get_merchant_products and get_fashion_products use cursor-based pagination. Each response includes a pageInfo object with hasNextPage (boolean) and endCursor (string). To fetch the next page, pass endCursor as the after parameter in your next request. The first parameter controls page size.Does the API expose order history, wishlists, or individual user account data?+
Can I filter products by category using these endpoints?+
list_categories returns all top-level categories with their Shopify GIDs, but the current product listing endpoints (get_merchant_products, get_fashion_products) filter by merchant rather than category. Category-based product filtering is not currently supported. You can fork this API on Parse and revise it to add a category-scoped product endpoint.