Documentation

HobbyQuantHQ API

All endpoints require the x-api-key header. During beta, use dev-key-change-me. Production keys will be issued per account tier.

Base URLhttps://hobbyquanthq.com/api/v1

GET/api/v1/pops

List all pops with pagination, filtering, and sorting.

Parameter	Type	Default	Description
page	int	1	Page number
limit	int	20	Results per page (max 100)
category	string	—	Filter by category (exact match)
series	string	—	Filter by series (partial match)
vaulted	bool	—	Filter by vaulted status
exclusive	string	—	Filter by exclusive retailer
sort	string	name	Sort field: name, series, number, category, release_year
order	string	asc	Sort order: asc or desc

GET/api/v1/pops/{id}

Retrieve a single pop by its numeric ID.

GET/api/v1/search

Full-text search across name, series, and pop number.

Parameter	Type	Default	Description
q	string	—	Search query (min 2 chars)
limit	int	50	Max results (max 100)

GET/api/v1/categories

List all categories with their pop counts.

GET/api/v1/trends/mock/{pop_id}

Return placeholder trend data for a given pop (Phase 1 — deterministic mock).

Interactive Swagger UI available on your running instance:

/api/docs or /api/redoc