Endpoint Playground

Try the Search Wish products API

Searches Wish's product catalog by keyword, with real offset-based pagination. Returns products with price, currency, rating, review count, and merchant id. A query with no matches returns a normal, empty result rather than an error.

What a live request returned

14 Oct 2026: 17 products; 8 fields had a value in every checked item.

Observed request: GET /wish/search?query=shoes&count=30
Fields with a value in every checked item: product_id, name, price, currency_code, rating, merchant_id, image_url, url

Sample value profiles: price: 13 to 191, median 91; name: “Pembe Potin Nakış Detaylı Hasır Dolgu Taban Önü Açık Kadın…” and 16 other values; image_url: canary.contestimg.wish.com.

Request: GET /wish/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.6%, median 9.23 s
Monitored request: GET /wish/search?query=shoes

Search Wish products API documentation Wish platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/wish/search?query=shoes' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	shoes	Search keyword
count	integer	No		Number of results per page, 1 to 70, defaults to 30
offset	integer	No		Result offset, 0-based, defaults to 0, must be an exact multiple of count up to 3 * count

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "shoes",
    "count": 30,
    "offset": 0,
    "result_count": 3,
    "next_offset": 30,
    "has_more": true,
    "products": [
      {
        "product_id": "68b46c0356ea5dba05e9f755",
        "name": "Waterproof Leather Casual Sneakers for Men, Lightweight Breathable Walking Shoes, Fashion Athletic Running Shoes",
        "price": 129.74,
        "currency_code": "HKD",
        "rating": 5,
        "merchant_id": "68ad644a332a553b38e113ec",
        "image_url": "https://canary.contestimg.wish.com/api/webimage/68b46c0356ea5dba05e9f755-medium.jpg",
        "url": "https://www.wish.com/product/68b46c0356ea5dba05e9f755"
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-search-universal-feed",
    "fetched_at": "2026-08-10T10:00:00Z"
  }
}

More Wish endpoints

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 Get Wish search suggestions

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestwish.searchResponseDocWish

GET /wish/search

Search Wish products

Response behavior

- Pagination is real, but Wish's own backend requires each subsequent page to be requested with the same `count` used on the first page of that sequence -- this endpoint replays that pattern internally, so a nonzero `offset` costs one extra upstream request per page walked. `next_offset` is the offset to request for the next page; `has_more` is `true` while more results remain. An `offset` that is not an exact multiple of `count`, or exceeds the reachable depth for the given `count`, returns `400` before any upstream request is made -- increase `count` to reach deeper pages in fewer steps. - A query with no matches returns a normal `200` with an empty `products` array and `has_more: false`, not an error. - `price` and `currency_code` reflect the requester's own localized pricing (e.g. a Hong Kong-geolocated request sees `HKD` prices); they are not always US dollars. - `rating` and `review_count` reflect the product's current aggregate rating; a brand-new product with no reviews yet returns `0` for both rather than an error.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Search keyword

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "shoes",
    "count": 30,
    "offset": 0,
    "result_count": 3,
    "next_offset": 30,
    "has_more": true,
    "products": [
      {
        "product_id": "68b46c0356ea5dba05e9f755",
        "name": "Waterproof Leather Casual Sneakers for Men, Lightweight Breathable Walking Shoes, Fashion Athletic Running Shoes",
        "price": 129.74,
        "currency_code": "HKD",
        "rating": 5,
        "merchant_id": "68ad644a332a553b38e113ec",
        "image_url": "https://canary.contestimg.wish.com/api/webimage/68b46c0356ea5dba05e9f755-medium.jpg",
        "url": "https://www.wish.com/product/68b46c0356ea5dba05e9f755"
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-search-universal-feed",
    "fetched_at": "2026-08-10T10:00:00Z"
  }
}

Endpoint Playground

Try the Search Wish products API

What a live request returned

14 Oct 2026: 17 products; 8 fields had a value in every checked item.

Observed request: GET /wish/search?query=shoes&count=30
Fields with a value in every checked item: product_id, name, price, currency_code, rating, merchant_id, image_url, url

Sample value profiles: price: 13 to 191, median 91; name: “Pembe Potin Nakış Detaylı Hasır Dolgu Taban Önü Açık Kadın…” and 16 other values; image_url: canary.contestimg.wish.com.

Request: GET /wish/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.6%, median 9.23 s
Monitored request: GET /wish/search?query=shoes

Search Wish products API documentation Wish platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/wish/search?query=shoes' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	shoes	Search keyword
count	integer	No		Number of results per page, 1 to 70, defaults to 30
offset	integer	No		Result offset, 0-based, defaults to 0, must be an exact multiple of count up to 3 * count

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "shoes",
    "count": 30,
    "offset": 0,
    "result_count": 3,
    "next_offset": 30,
    "has_more": true,
    "products": [
      {
        "product_id": "68b46c0356ea5dba05e9f755",
        "name": "Waterproof Leather Casual Sneakers for Men, Lightweight Breathable Walking Shoes, Fashion Athletic Running Shoes",
        "price": 129.74,
        "currency_code": "HKD",
        "rating": 5,
        "merchant_id": "68ad644a332a553b38e113ec",
        "image_url": "https://canary.contestimg.wish.com/api/webimage/68b46c0356ea5dba05e9f755-medium.jpg",
        "url": "https://www.wish.com/product/68b46c0356ea5dba05e9f755"
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-search-universal-feed",
    "fetched_at": "2026-08-10T10:00:00Z"
  }
}

More Wish endpoints

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 Get Wish search suggestions

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestwish.searchResponseDocWish

GET /wish/search

Search Wish products

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Search keyword

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "shoes",
    "count": 30,
    "offset": 0,
    "result_count": 3,
    "next_offset": 30,
    "has_more": true,
    "products": [
      {
        "product_id": "68b46c0356ea5dba05e9f755",
        "name": "Waterproof Leather Casual Sneakers for Men, Lightweight Breathable Walking Shoes, Fashion Athletic Running Shoes",
        "price": 129.74,
        "currency_code": "HKD",
        "rating": 5,
        "merchant_id": "68ad644a332a553b38e113ec",
        "image_url": "https://canary.contestimg.wish.com/api/webimage/68b46c0356ea5dba05e9f755-medium.jpg",
        "url": "https://www.wish.com/product/68b46c0356ea5dba05e9f755"
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-search-universal-feed",
    "fetched_at": "2026-08-10T10:00:00Z"
  }
}