Catalog

Search the shelf, or read one item

The catalogue in compact rows — id, name, price in USDC, the price tiers, instant or human-fulfilled, what the item reads, and where to buy it or read its listing. q matches an item's id, name, subtitle and description; max_price_usdc is a ceiling items match at or below; item_id returns that one item with its description and at-a-glance block instead of a list. No filter answers with the whole shelf. Every answer carries what matched and what it matched from, and states that the order is the shelf's own: nothing here is ranked, scored or recommended. A cap that does not parse is a 400 rather than a silently wider answer, and an id the shelf does not carry is a 404 naming the ids it does. Free.

get/api/catalog/v1

Request

  • Base URL: https://scvd.store
  • URL: https://scvd.store/api/catalog/v1
  • Auth: none required

Query parameters

qstring

Words matched against an item's id, name, subtitle and description.

max_price_usdcnumber

A ceiling in USDC. Items priced at or below it match.

item_idstring

One item's id. The answer carries that item alone with its description; an unknown id answers 404 naming the ids the shelf holds.

Headers

If-None-Matchstring

Send a prior ETag (SHA-256 of exact response bytes). Unchanged content returns 304 with no body.

Response

OK

queryobject

The filter that was applied, echoed back.

matchedinteger required

How many items matched.

ofinteger required

How many are on the shelf. The denominator travels with the count.

how_this_was_orderedstring
scope'active_menu'
whole_cataloguestring uri

Changes

No recorded changes to this operation across all 1 revision of this API.