Search marketplace categories

Google product taxonomy and Meta product categories. Exact matches first, then prefix matches, then the rest alphabetically. Public.

Query Parameters

q?string

Matches part of the category path, case-insensitively. Empty lists everything.

provider?string

One provider; both when omitted.

Value in"google" | "facebook"

locale?string

en-US (default) or pt-BR.

limit?integer

Page size, 1 to 200. Defaults to 50.

Formatint64

Range1 <= value <= 200

cursor?string

next_cursor from the previous page. Omit for the first page.

offset?integer

Rows to skip, for UIs that jump to a page number. Ignored when cursor is set. Prefer cursor for walking a whole list.

Formatint64

Range0 <= value

include_total?boolean

Also return total, the count of all matching rows. Costs an extra query; leave off when you only walk pages.

curl -X GET "https://example.com/taxonomy/search?limit=50"

{
  "data": [
    {
      "label": "string",
      "value": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string",
  "total": 0
}

{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}

{
  "code": "not_found",
  "details": {},
  "error": "Order not found"
}