Developers

A small, read-only JSON API over what anyone can already see on hyp.lt — for agents, price comparison and integrations. No key needed.

Basics

Base URL https://hyp.lt. Every endpoint is GET and answers JSON with a data field, or an error field and a 4xx status.
Prices are whole rupees and include any running sale. Stock is shown only as in stock or not.
Up to 120 requests a minute from one address; past that you get 429 with a Retry-After header. Responses may be cached for a minute.
CORS is open, so the API works from a browser.
Only public information: no buyer or shop contact details, and nothing from accounts.

Endpoints

GET /api/v1/listings

Search live listings. Takes the same query parameters as /shop.

q: Free text
type: course · material · design
category: A category slug from /api/v1/categories
min, max: Price in rupees
sort: relevance · new · price-asc · price-desc · reviews
free: 1 for listings that ship free
page, limit: Page number; 1–48 results a page (default 24)

Try it

/api/v1/listings?q=kalamkari&type=design&limit=5

GET /api/v1/listings/{slug}

One live listing: price now, options, images, shop, rating (only when it has reviews), course or design details.

Try it

/api/v1/listings/fabric-paint-set-of-8

GET /api/v1/shops/{slug}

An open shop: about, location, policies, rating and its live listings.

Try it

/api/v1/shops/meera-kala

GET /api/v1/categories

The category tree and the attributes buyers filter by.

Try it

/api/v1/categories

Using the data

Link back to the listing's url when you show it, and don't present shops' photos or text as your own. The terms of use apply. For an agent-readable overview of the whole site, see llms.txt.

Menu

Developers

Basics

Endpoints

GET /api/v1/listings

GET /api/v1/listings/{slug}

GET /api/v1/shops/{slug}

GET /api/v1/categories

Using the data

Bag (0)