Platitun · API · Catalogue and requests · Search the catalogue

Search the catalogue

GET /api/v1/catalog/services

Key scope: catalog · read only

The marketplace service catalogue. It is read-only: only the marketplace edits it, and that is deliberate — a buyer cannot tell two differently named “Cursor Pro” entries apart. Disabled services are not returned at all.

The cursor is the slug of the last service seen, and the order is by slug: it is stable, unlike a page number.

Query filters

Field	Type	What it is
`q`	`string`	Search by service name, vendor or slug.
`category`	`string`	Only from this catalogue section.
`limit`	`integer`	How many records to return. Default 50, maximum 200.
`cursor`	`string`	The nextCursor value from the previous response. There are no page numbers: the list changes while you page.

Response fields

Field	Type	What it is
`items`	`array`	The records of this page.
`items[].service`	`string`	The service slug — the name used for it in every other endpoint.
`items[].name`	`string`	The name as the vendor writes it.
`items[].vendor`	`string`	Who makes the service.
`items[].categories`	`array`	Catalogue sections: a service can belong to several at once.
`items[].productTypes`	`array`	Which product types are possible for this position.
`items[].tariffCount`	`integer`	How many vendor plans the service has.
`nextCursor`	`string\|null`	The next page cursor. Empty — this is the last page.

Example

GET /api/v1/catalog/services?q=cursor&limit=2

→ 200 { "items": [ { "service": "cursor", "name": "Cursor", "vendor": "Anysphere",
        "productTypes": ["subscription","account_with_subscription","account"],
        "tariffCount": 3 } ], "nextCursor": null }

Nearby in this section

GET /api/v1/me — Who am I
GET /api/v1/catalog/services/{slug} — Everything about a position
GET /api/v1/catalog/usual-price — The usual price for a position
GET /api/v1/catalog/demand — Demand: what buyers are waiting for
GET /api/v1/catalog/requests — My catalogue requests
POST /api/v1/catalog/requests — Request a new catalogue position