List categories

GET

/listings/categories

const url = 'https://acme.mykreezalid.com/api/partners/v1/listings/categories?page=1&limit=25';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://acme.mykreezalid.com/api/partners/v1/listings/categories?page=1&limit=25' \
  --header 'Authorization: Basic <credentials>'

Lists the marketplace’s listing categories. Use a category’s id as category_id when you create or update a listing.

Authorizations

basic

Parameters

Query Parameters

page

integer

default: 1 >= 1

Page to return, starting at 1. Pages hold 25 results by default; keep requesting the next page until one comes back with fewer results than limit.

limit

integer

default: 25 >= 1 <= 100

Number of results per page, at most 100.

Responses

200

The marketplace’s categories.

application/json

object

categories

Array<object>

object

integer

title

string

page_title

Title of the category page.

string

nullable

description

string

nullable

slug

string

listing_count

Number of listings in the category.

integer

Example

{
  "categories": [
    {
      "id": 12,
      "title": "Bikes",
      "slug": "bikes"
    }
  ]
}

403

Missing or wrong API credentials.