Docs menu

Wish API endpoint

Wish Category & Filter Tree API

Returns Wish's own top navigation/category tree (e.g. "Popular", "Deals Hub", "Fashion", "Gadgets") plus each category's nested filter groups (e.g. Color, Rating) where present. This is a static, site-wide taxonomy -- it takes no input and its result does not vary by search term or category.

GETapiKey3 credits/requestWishwish.categoriesResponseDoc/wish/categories

Endpoint facts

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

Wish Scraper API Try Wish Category & Filter Tree API in Playground Wish API documentation

How this endpoint behaves

Requires the x-api-key header. No query or path parameters -- this is a static, site-wide taxonomy that does not vary by search term or category.

Notable response behavior:

Each category's filter_id is Wish's own stable identifier for that nav tab.
is_main_tab marks the small set of primary tabs Wish's own header nav highlights (e.g. "Popular", "Deals Hub", "Recently Viewed") versus the longer tail of secondary category tags.
Most categories return an empty filter_groups list; only "Popular" (Wish's own default/landing tab) was observed carrying nested filter groups such as Color and Rating.

Live monitoring

Monitored request: GET /wish/categories
Checks passed, 7 days to 14 Oct 2026: 99.4%
Median response time: 5.53 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /wish/categories
Items in categories: 21
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 21 checked	Values in the sample
name	21	“Popular” and 20 other values
filter_id	21
is_main_tab	21	true in 4 of 21
filter_groups	1	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wish/categories" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Popular",
        "filter_id": "tabbed_feed_latest",
        "is_main_tab": true,
        "filter_groups": [
          {
            "id": "Color",
            "name": "Color",
            "icon_url": "https://main.cdn.wish.com/web/9a9befad15d4/img/filtered_feed/filter_feed_filter_color.png",
            "filters": [
              {
                "name": "Blue",
                "filter_id": "color_53dc217e21a8632b3c6e0735",
                "is_quick_filter": false,
                "is_toggle": false,
                "default_selected": false
              }
            ]
          }
        ]
      },
      {
        "name": "Deals Hub",
        "filter_id": "dealshub_flashsale",
        "is_main_tab": true,
        "filter_groups": []
      },
      {
        "name": "Fashion",
        "filter_id": "tag_53dc186321a86318bdc87ef8",
        "is_main_tab": false,
        "filter_groups": []
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-filtered-feed-categories",
    "fetched_at": "2026-08-12T10:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/wish.categoriesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wish.CategoriesResponse	No
data.categories	array	No
data.categories[].filter_groups	array	No
data.categories[].filter_groups[].filters	array	No
data.categories[].filter_groups[].filters[].default_selected	boolean	No
data.categories[].filter_groups[].filters[].filter_id	string	No
data.categories[].filter_groups[].filters[].is_quick_filter	boolean	No
data.categories[].filter_groups[].filters[].is_toggle	boolean	No
data.categories[].filter_groups[].filters[].name	string	No
data.categories[].filter_groups[].icon_url	string	No
data.categories[].filter_groups[].id	string	No
data.categories[].filter_groups[].name	string	No
data.categories[].filter_id	string	No
data.categories[].is_main_tab	boolean	No
data.categories[].name	string	No
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
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/categories" \
  -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 Get a Wish product's full detail API documentation Get a Wish product's related items API documentation Wish Product Reviews API documentation Search Wish products API documentation Get Wish search suggestions API documentation

Open in Playground Back to group

Docs menu

Wish API endpoint

Wish Category & Filter Tree API

GETapiKey3 credits/requestWishwish.categoriesResponseDoc/wish/categories

Endpoint facts

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

Wish Scraper API Try Wish Category & Filter Tree API in Playground Wish API documentation

How this endpoint behaves

Requires the x-api-key header. No query or path parameters -- this is a static, site-wide taxonomy that does not vary by search term or category.

Notable response behavior:

Each category's filter_id is Wish's own stable identifier for that nav tab.
is_main_tab marks the small set of primary tabs Wish's own header nav highlights (e.g. "Popular", "Deals Hub", "Recently Viewed") versus the longer tail of secondary category tags.
Most categories return an empty filter_groups list; only "Popular" (Wish's own default/landing tab) was observed carrying nested filter groups such as Color and Rating.

Live monitoring

Monitored request: GET /wish/categories
Checks passed, 7 days to 14 Oct 2026: 99.4%
Median response time: 5.53 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /wish/categories
Items in categories: 21
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 21 checked	Values in the sample
name	21	“Popular” and 20 other values
filter_id	21
is_main_tab	21	true in 4 of 21
filter_groups	1	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/wish/categories" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "categories": [
      {
        "name": "Popular",
        "filter_id": "tabbed_feed_latest",
        "is_main_tab": true,
        "filter_groups": [
          {
            "id": "Color",
            "name": "Color",
            "icon_url": "https://main.cdn.wish.com/web/9a9befad15d4/img/filtered_feed/filter_feed_filter_color.png",
            "filters": [
              {
                "name": "Blue",
                "filter_id": "color_53dc217e21a8632b3c6e0735",
                "is_quick_filter": false,
                "is_toggle": false,
                "default_selected": false
              }
            ]
          }
        ]
      },
      {
        "name": "Deals Hub",
        "filter_id": "dealshub_flashsale",
        "is_main_tab": true,
        "filter_groups": []
      },
      {
        "name": "Fashion",
        "filter_id": "tag_53dc186321a86318bdc87ef8",
        "is_main_tab": false,
        "filter_groups": []
      }
    ],
    "source_url": "https://www.wish.com/api/feed/get-filtered-feed-categories",
    "fetched_at": "2026-08-12T10:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/wish.categoriesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	wish.CategoriesResponse	No
data.categories	array	No
data.categories[].filter_groups	array	No
data.categories[].filter_groups[].filters	array	No
data.categories[].filter_groups[].filters[].default_selected	boolean	No
data.categories[].filter_groups[].filters[].filter_id	string	No
data.categories[].filter_groups[].filters[].is_quick_filter	boolean	No
data.categories[].filter_groups[].filters[].is_toggle	boolean	No
data.categories[].filter_groups[].filters[].name	string	No
data.categories[].filter_groups[].icon_url	string	No
data.categories[].filter_groups[].id	string	No
data.categories[].filter_groups[].name	string	No
data.categories[].filter_id	string	No
data.categories[].is_main_tab	boolean	No
data.categories[].name	string	No
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
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/categories" \
  -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

Wish Category & Filter Tree 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

Wish Category & Filter Tree 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