List active listing categories
Authorization
apiKey x-api-key<token>
API key created in your Marka account settings, sent as an x-api-key header (an Authorization: Bearer mk_… header is accepted as an equivalent spelling). Key-authenticated writes additionally require the api_write entitlement, which the Pro plan and above carry. A signed-in browser session cookie is also accepted for interactive exploration from the Marka web app; SDK and server-to-server clients always use a key.
In: header
Query Parameters
limit?integer
How many categories to return, 1-50. Defaults to 50, which returns the whole set unless more than 50 categories carry active listings — there is no second page, so a lower limit only truncates the tail, it never surfaces different categories.
Range
1 <= value <= 50Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/categories"{ "categories": [ { "categoryPath": "string", "count": 0, "label": "string" } ]}