Published NFT exposes a small public HTTP API that powers the bookstore, analytics dashboards, NFT-ownership checks, and the Cindy AI assistant. All responses are JSON, and read endpoints are public.
- Base URL:
https://publishednft.io/api - Format: JSON
- Auth: none required for the public read endpoints below (write/admin endpoints are omitted)
Endpoints
| Area | Method & path | Description |
|---|---|---|
| Books | GET /books |
List and search the catalog (filter by category, type, audiobook; sort; paginate). |
| Books | GET /books/{slug} |
Fetch a single title by slug. |
| Authors | GET /authors |
List author profiles. |
| Authors | GET /authors/{id} |
Fetch a single author by id. |
| Analytics | GET /analytics |
Collection stats, transactions, or holders (hybrid on-chain pipeline, 5-min cache). |
| Analytics | GET /analytics/marketplace |
Aggregate marketplace sales, volume, and floor. |
| Analytics | GET /analytics/collections |
Per-collection analytics summary. |
| Analytics | GET /analytics/published-daily |
Readership and mint analytics for the daily edition. |
| NFT | POST /check-genesis-pass |
Check whether a Flow address holds a Library / Genesis Pass. |
| Docs assistant | GET /mcp |
Health of the self-hosted MCP server that powers Cindy. |
Example
# List the 10 newest classics
curl "https://publishednft.io/api/books?category=classics&sort=newest&limit=10"
# Check Library / Genesis Pass ownership on mainnet
curl -X POST "https://publishednft.io/api/check-genesis-pass" \
-H "Content-Type: application/json" \
-d '{"address":"0xd7113c1725f5fedf","network":"mainnet"}'
Full specification
The complete machine-readable definition — every parameter, enum, and response schema — is published as an OpenAPI 3.1 spec.
{% hint style="info" %}
An interactive, always-up-to-date reference can be embedded on this page from the GitBook editor: insert an OpenAPI block and select the publishednft-api spec (already uploaded to this organization).
{% endhint %}