API Reference
Use Crawlora's Wish API endpoints to extract supported public Wish data as structured JSON. This documentation covers 6 active endpoints including Get Wish's category and filter navigation tree, Get a Wish product's full detail, Get a Wish product's related items, Get a Wish product's customer reviews, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as id, query, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/wish/search?query=coffee&count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/wish/categoriesapiKey3 credits/requestReturns Wish's own top navigation/category tree (e.g. "Popular", "Deals Hub", "Fashion", "Gadgets") plus each category's nested filter groups (e.g. Color, Rating) where present. This is a static, site-wide taxonomy -- it takes no input and its result does not vary by search term or category.
Required params: None
/wish/product/{id}apiKey3 credits/requestReturns one Wish product's full detail: name, description, sold-out state, aggregate rating, image URLs, and every purchasable variation with its own price, currency, inventory, and merchant. id is taken from a search result's product_id field or a product page's URL. An unrecognized id returns 404.
Required params: id:path
/wish/product/{id}/relatedapiKey3 credits/requestReturns a Wish product's related-item rails: shelves of similar products, grouped by rail (e.g. general similar items, a faster-shipping-eligible subset). id is taken from a search result's product_id field or a product page's URL. A faster-shipping rail with no eligible items, or a nonexistent id, returns a normal, empty result rather than an error.
Required params: id:path
/wish/product/{id}/reviewsapiKey3 credits/requestReturns a Wish product's normalized customer reviews. id is taken from a search result's product_id field or a product page's URL. A product with zero reviews returns a normal, empty result rather than an error. A caller wanting more reviews should re-request with a larger count -- this endpoint does not support an offset/cursor parameter, since the upstream source does not support one.
Required params: id:path
/wish/searchapiKey3 credits/requestSearches Wish's product catalog by keyword, with real offset-based pagination. Returns normalized products with price, currency, rating, review count, and merchant id. A query with no matches returns a normal, empty result rather than an error.
Required params: query:query
/wish/suggestapiKey3 credits/requestReturns Wish's own search-suggestion (typeahead) result for a partial search term: a flat list of suggested search terms, no product data. A partial term with no matches returns a normal, empty result rather than an error.
Required params: query:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Wish's category and filter navigation tree | /wish/categories | GET | 3 credits/request | None | View docs | Try endpoint |
| Get a Wish product's full detail | /wish/product/{id} | GET | 3 credits/request | id:path | View docs | Try endpoint |
| Get a Wish product's related items | /wish/product/{id}/related | GET | 3 credits/request | id:path | View docs | Try endpoint |
| Get a Wish product's customer reviews | /wish/product/{id}/reviews | GET | 3 credits/request | id:path | View docs | Try endpoint |
| Search Wish products | /wish/search | GET | 3 credits/request | query:query | View docs | Try endpoint |
| Get Wish search suggestions | /wish/suggest | GET | 3 credits/request | query:query | View docs | Try endpoint |