HobbyQuantHQ
Back to Blog

Developer Guide

Building with the HobbyQuantHQ API: A Developer's Guide

November 10, 202510 min read

The HobbyQuantHQ public API gives you programmatic access to 15,000+ Funko Pops, real-time analytics, marketplace listings, and webhook events. Here's everything you need to get started.

Authentication

All API requests require an X-API-Key header. Create a key from your Developer portal after registering. Free accounts get up to 5 active keys.

curl https://hobbyquanthq.com/public/v1/funko/pops \
  -H "X-API-Key: hq_live_your_key" \
  -G -d "q=Baby+Yoda" -d "limit=10"

Key endpoints

GET /public/v1/funko/pops — search and paginate all pops. Supports q (search), franchise, set_id, limit, and offset.

GET /public/v1/analytics/funko/trends — market trend data including momentum scores and price movement percentages.

GET /public/v1/listings — browse active marketplace listings with full filtering support.

Setting up webhooks

Register a webhook endpoint via POST /public/v1/webhooks. Include your HTTPS URL and the event types you want. We'll sign each payload with HMAC-SHA256 — verify using theX-HQ-Signature header and your webhook secret.

Building a Discord bot

Subscribe to listing.created events and filter by franchise or price range. Forward matching listings to your Discord channel via a webhook. A basic implementation takes about 30 lines of Node.js.