Wish Search API Documentation Search public Wish products by keyword. Each result carries the 24-hex product id, title, full-size image, local price and USD price as numbers with currency, original price, discount, rating, review count and merchant id. original_price and discount_percent are null when Wish ships no real list price. Paging uses a real offset; page_size reports the number of items actually received, normally 11 to 28 per page of 30. A search without hits is a successful response with an empty results list. Empty answers and failed requests are never charged. 1 credit per answer with data.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
1 optional filter available.
string
Required
Search keywords, e.g. phone case.
coffee shops
integer
Optional
1-based page, default 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"query": "phone case",
"results": [
{
"url": "https://www.wish.com/product/66d57c5e2bc736b0f04daa8b",
"price": {
"amount": 3.29,
"currency": "USD"
},
"title": "Silicone phone case",
"rating": 4.5,
"currency": "USD",
"image_url": "https://cdn.example.test/case.jpg",
"price_usd": {
"amount": 3.29,
"currency": "USD"
},
"product_id": "66d57c5e2bc736b0f04daa8b",
"merchant_id": "5a1b2c3d4e5f60718293a4b5",
"review_count": 812,
"original_price": {
"amount": 9.99,
"currency": "USD"
},
"discount_percent": 67
}
],
"has_more": true,
"page_size": 1,
"next_offset": 30,
"filter_groups": [],
"no_more_items": false,
"total_results": 1200
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"A search query is required, e.g. phone case."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Wish did not return usable data. This response is not billable.
{
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Wish is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.