Docs menu

Wish API endpoint

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.

GETapiKey3 credits/requestWishwish.searchResponseDoc/wish/search

Endpoint facts

Method: GET
API path: /wish/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Wish
Response schema: #/definitions/wish.searchResponseDoc

Wish Scraper API Try Search Wish products API in Playground Wish API documentation

How this endpoint behaves

query is required, 1 to 200 characters. count is optional, 1 to 70, defaults to 30. offset is optional, 0-based, defaults to 0, and must be an exact multiple of count (e.g. with the default count=30, valid offsets are 0, 30, 60, 90) up to 3 * count.

Notable 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.

Live monitoring

Monitored request: GET /wish/search?query=shoes
Checks passed, 7 days to 14 Oct 2026: 99.6%
Median response time: 9.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /wish/search?query=shoes&count=30
Items in products: 17
Fields filled in every checked item: 8

Field	Filled in, of 17 checked	Values in the sample
product_id	17
name	17	“Pembe Potin Nakış Detaylı Hasır Dolgu Taban Önü Açık Kadın…” and 16 other values
price	17	13 to 191, median 91
currency_code	17
rating	17	5
merchant_id	17
image_url	17	canary.contestimg.wish.com
url	17	wish.com

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Search keyword	shoes
count	integer	No	30	Number of results per page, 1 to 70, defaults to 30	30
offset	integer	No	0	Result offset, 0-based, defaults to 0, must be an exact multiple of count up to 3 * count	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wish/search?query=shoes&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

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

Request schema

No body schema

Response schema

#/definitions/wish.searchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wish.SearchResponse	No
data.count	integer	No
data.fetched_at	string	No
data.has_more	boolean	No
data.next_offset	integer	No
data.offset	integer	No
data.products	array	No
data.products[].currency_code	string	No
data.products[].image_url	string	No
data.products[].merchant_id	string	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].product_id	string	No
data.products[].rating	number	No
data.products[].review_count	integer	No
data.products[].url	string	No
data.query	string	No
data.result_count	integer	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/wish/search?query=shoes&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Wish endpoint docs Wish Scraper API Wish Category & Filter Tree API documentation Get a Wish product's full detail API documentation Get a Wish product's related items API documentation Wish Product Reviews API documentation Get Wish search suggestions API documentation

Open in Playground Back to group

Docs menu

Wish API endpoint

Search Wish products API

GETapiKey3 credits/requestWishwish.searchResponseDoc/wish/search

Endpoint facts

Method: GET
API path: /wish/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Wish
Response schema: #/definitions/wish.searchResponseDoc

Wish Scraper API Try Search Wish products API in Playground Wish API documentation

How this endpoint behaves

Notable 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.

Live monitoring

Monitored request: GET /wish/search?query=shoes
Checks passed, 7 days to 14 Oct 2026: 99.6%
Median response time: 9.23 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /wish/search?query=shoes&count=30
Items in products: 17
Fields filled in every checked item: 8

Field	Filled in, of 17 checked	Values in the sample
product_id	17
name	17	“Pembe Potin Nakış Detaylı Hasır Dolgu Taban Önü Açık Kadın…” and 16 other values
price	17	13 to 191, median 91
currency_code	17
rating	17	5
merchant_id	17
image_url	17	canary.contestimg.wish.com
url	17	wish.com

Request parameters

Parameter	Type	Required	Default	Description	Example
query	string	Yes		Search keyword	shoes
count	integer	No	30	Number of results per page, 1 to 70, defaults to 30	30
offset	integer	No	0	Result offset, 0-based, defaults to 0, must be an exact multiple of count up to 3 * count	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wish/search?query=shoes&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

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

Request schema

No body schema

Response schema

#/definitions/wish.searchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wish.SearchResponse	No
data.count	integer	No
data.fetched_at	string	No
data.has_more	boolean	No
data.next_offset	integer	No
data.offset	integer	No
data.products	array	No
data.products[].currency_code	string	No
data.products[].image_url	string	No
data.products[].merchant_id	string	No
data.products[].name	string	No
data.products[].price	number	No
data.products[].product_id	string	No
data.products[].rating	number	No
data.products[].review_count	integer	No
data.products[].url	string	No
data.query	string	No
data.result_count	integer	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/wish/search?query=shoes&count=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Search Wish products API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Search Wish products API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related