Developer and citation resources
Build with public collectible data—and keep the evidence attached.
CollectAIO exposes read-only JSON endpoints for search, browse, item details, and releases. Use frozen report CSVs when a claim needs a stable evidence date, and link readers to the canonical page for current context.
Published and maintained by CollectAIO. Last reviewed July 30, 2026.
Public read-only API
Start with search, then preserve the canonical slug.
Requests can use https://www.collectaio.com as the base URL. The production site proxies these paths to the API. Third-party browser origins are not generally allowed by CORS, so external applications should make requests from their server or build process.
| Method | Path | Use |
|---|---|---|
| GET | /api/v2/search?q={query}&page=1&per_page=24 | Find public items and categories when you do not already know a canonical slug. |
| GET | /api/v1/items/{slug} | Read one public item, its variations, market signals, listings, and price history. |
| GET | /api/v2/browse/{slug}/items?page=1&per_page=24 | Traverse a public category or set with bounded pagination. |
| GET | /api/v1/release_watch | Read the public collectible release-watch dataset. |
| GET | /api/v1/items/public?include_meta=1&page=1&per=5000 | Discover eligible public item URLs in bounded sitemap-style pages. |
Pro Data API
Use a revocable token for prices and saved collection goals.
Pro tokens carry catalog:read and collection:read scopes. They work with exact product JSON, bounded price exports, and the same saved multi-set goals used on web and iPhone. Requests are read-only, limited to 120 calls per five minutes per token, and appear in your token access history. Collection-goal responses are limited to the token owner.
Consumer Pro access is for personal or internal use. A paid customer-facing product, retained commercial dataset, or redistribution workflow requires separate written commercial approval with its own credential, usage allowance, retention terms, and attribution requirements. Contact CollectAIO through the About page before launch.
| Method | Path | Use |
|---|---|---|
| GET | /api/v1/data/products/{slug} | Retrieve one exact product and every current variation price by canonical slug. |
| GET | /api/v1/data/products?slugs={slug1},{slug2} | Retrieve up to 100 products in request order and identify any missing slugs. |
| GET | /api/v1/data/products.csv?slugs={slug1},{slug2} | Export one row per variation with product identity, current price, basis, and freshness. |
| GET | /api/v1/data/collection_goals | List your saved multi-set goals and combined progress with collection:read access. |
| GET | /api/v1/data/collection_goals/{goal_id} | Read one goal, its saved filters, per-set progress, and paginated missing cards. |
Exact product JSON
curl 'https://api.collectaio.com/api/v1/data/products/base-set-charizard-004-102' \
--header 'Authorization: Bearer YOUR_TOKEN'Bounded current-price CSV
curl --get 'https://api.collectaio.com/api/v1/data/products.csv' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data-urlencode 'slugs=base-set-charizard-004-102,earthbound-super-nintendo' \
--output collectaio-current-prices.csvSaved collection goal
curl 'https://api.collectaio.com/api/v1/data/collection_goals/GOAL_ID?page=1&per_page=250' \
--header 'Authorization: Bearer YOUR_TOKEN'Server-side quick start
Fetch an exact item.
Search first when the slug is unknown. Once resolved, store the slug and cite the matching public item page.
const slug = 'me04-chaos-rising-chaos-rising-elite-trainer-box';
const response = await fetch(
`https://www.collectaio.com/api/v1/items/${slug}`
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const item = await response.json();
const canonicalUrl =
`https://www.collectaio.com/item/${item.slug}`;Command line
Search with bounded pagination.
Keep list requests small, cache responses, and follow canonical URLs returned through slugs.
curl --get 'https://www.collectaio.com/api/v2/search' \
--data-urlencode 'q=Chaos Rising ETB' \
--data 'page=1' \
--data 'per_page=10'Embeddable evidence card
Embed a dated report without copying its claims out of context.
The card is a lightweight, cacheable HTML document with a canonical attribution link. Its numbers come from the frozen July 12 report, so later price changes do not silently rewrite an existing embed.
Copy this iframe
<iframe
src="https://www.collectaio.com/embed/report/pokemon-sealed/2026-07-12"
title="CollectAIO Pokemon sealed market report"
width="640"
height="360"
loading="lazy"
sandbox="allow-popups allow-popups-to-escape-sandbox"
style="max-width:100%;border:0;border-radius:10px"
></iframe>Responsible use
Keep integrations bounded and claims qualified.
There is no public uptime, latency, or request-volume SLA. Cache responses, avoid high-rate crawling, keep pagination bounded, and do not use private or authenticated routes.
A Collect Pro subscription does not grant the right to resell, sublicense, bulk redistribute, or use CollectAIO data inside a paid third-party product. Those uses require a separate written commercial agreement.
Do not flatten sold comps, active asks, source-guide values, and CollectAIO estimates into one undifferentiated price. Preserve basis, confidence, sample size, freshness, and evidence date when those fields are present.
For published claims, cite the canonical item, category, guide, or dated report. Use the CollectAIO methodology to explain value construction and limitations.
Questions about an integration or data correction can be sent through the About and contact page.