Skip to content
Scrappa Get API key
Wish API 1 credit / request

Wish Search API Documentation

GET https://scrappa.co/api/wish/search

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.

Wish Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/wish/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "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",
...

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.

query string Required

Search keywords, e.g. phone case.

Example value coffee shops
page integer Optional

1-based page, default 1.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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.

422

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"
}
503

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.