# Wish Product API Documentation

<p><strong>Wish Product API Documentation</strong> Read one Wish product by the 24-hex id returned from search or related. The answer holds variations with prices in the local currency, inventory, color, size, merchant and shipping, plus full-size images, a rating and an offer summary. List prices are only returned when they exceed the sale price. Shipping options appear once per product, not once per variation. Internal merchant and logistics fields are removed. An unknown id returns 404 and costs no credit. 1 credit per answer with data.</p>

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

## 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 |
| --- | --- | --- | --- |
| `product_id` | string | Yes | The 24-hex id from Wish search or related. |

## Example response

```json
{
    "data": {
        "url": "https://www.wish.com/product/66d57c5e2bc736b0f04daa8b",
        "title": "Silicone phone case",
        "offers": {
            "price": {
                "amount": 15.08,
                "currency": "USD"
            },
            "currency": "USD",
            "original_price": {
                "amount": 21.57,
                "currency": "USD"
            }
        },
        "currency": "USD",
        "image_urls": [
            "https://cdn.example.test/case.jpg"
        ],
        "main_image": "https://cdn.example.test/case.jpg",
        "product_id": "66d57c5e2bc736b0f04daa8b",
        "variations": [
            {
                "size": "M",
                "color": "Blue",
                "price": {
                    "amount": 15.08,
                    "currency": "USD"
                },
                "currency": "USD",
                "inventory": 42,
                "ships_from": "Overseas",
                "merchant_id": "5a1b2c3d4e5f60718293a4b5",
                "variation_id": "68b46c0356ea5dba05e9f755",
                "shipping_cost": {
                    "amount": 2.99,
                    "currency": "USD"
                },
                "original_price": {
                    "amount": 21.57,
                    "currency": "USD"
                }
            }
        ],
        "module_count": 19,
        "aggregate_rating": {
            "rating": 4,
            "review_count": 5
        },
        "shipping_options": [
            {
                "name": "Standard",
                "price": {
                    "amount": 2.99,
                    "currency": "USD"
                },
                "max_days": 31,
                "min_days": 13,
                "time_string": "Dec 3-21"
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The product id is valid but Wish has no detail for it. This response is not billable. |
| 422 | Validation Error | The product id is missing or not a 24-hex id. |
| 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)
