# Wish Search API Documentation

<p><strong>Wish Search API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/wish-api/wish_search](https://scrappa.co/docs/wish-api/wish_search)
- **API group:** Wish API
- **Endpoint:** `GET https://scrappa.co/api/wish/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keywords, e.g. phone case. |
| `page` | integer | No | 1-based page, default 1. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Wish did not return usable data. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
