Product tags

GET /product-tags

List the tags your products carry, alphabetically by default, with how many products carry each. A tag exists only while a product carries it: tag a product to create one, and use the bulk update to rename or remove one. Supports filtering and cursor pagination.

Requires the products:read permission.

Query parameters

limitnumber

The number of records to return.

cursorstring

A pagination cursor. Fetch the next page by passing the nextCursor value from the previous response.

sortname | -name | productsCount | -productsCount | createdAt | -createdAt

The sort order. Prefix a field with - to sort descending. Defaults to name.

filterstring

A JSON-encoded filter document, for example {"createdAt":{"$gte":"2025-01-01T00:00:00Z"}}. Filterable fields: name, createdAt. See Filtering for the syntax.

Request
curl \
  "https://your-store.meisei.app/api/product-tags" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY"
Response
{
  "data": [
    {
      "name": "string",
      "productsCount": 0,
      "createdAt": "2025-01-15T09:30:00Z"
    }
  ],
  "nextCursor": "string"
}