External adoption
Adopt Harpd data
Three ways to build on Harpd, one licence. Pull the open datasets, call the public API, or drop in an embed — every surface shares one schema and one CC BY 4.0licence, so a tool built against one works against all of them.
Quick answer
How do I start building on Harpd data?
Start from the published catalog: 1,122 products and every category board as JSON and CSV, regenerated from live Rank data and licensed CC BY 4.0. No key, no signup. If you render the data, attribute Harpd with the Powered by Harpd badge and link the canonical source.
- Products
- 1,122
- Auth
- None for public endpoints
- License
- CC BY 4.0
- Schema
- v1.0
Data source: Harpd public datasetsDataset indexAPI referenceEmbed generator
1 · Pull the open datasets
Every dataset is a static JSON/CSV file, cached at the edge, no key required.
curl -s https://harpd.com/data/rank.json | jq '.products | length'
# -> 1122 products (CC BY 4.0)Full list at /data/ — rank, products, categories, research, benchmarks, pricing, and the Discovery Index. Field dictionary at /data/schema.json.
2 · Call the public API
The live board family and the per-page SEO/GEO payload — read-only, key-less.
// No key, no signup. Edge-cached, CC BY 4.0.
const rank = await fetch('https://harpd.com/data/rank.json').then((r) => r.json())
console.log(rank.products.length) // 1122Endpoint reference: /developers/api/. The collector's live board lives at api.harpd.com/api/rank.
3 · Drop in an embed
A responsive, iframe-safe leaderboard widget. No build step, attribution included.
<script src="https://harpd.com/embed/rank.js" data-limit="10" data-theme="auto" async></script>Pick type, category and theme at the embed generator, then copy the code.
Attribute Harpd
CC BY 4.0 requires attribution. Drop the Powered by Harpd badge wherever you render Harpd data — it links to the canonical source and carries the licence.
<a href="https://harpd.com/data/" rel="noopener">
<img src="https://harpd.com/embed/badge/powered-by-harpd-open-data.svg" alt="Powered by Harpd Open Data" height="20" />
</a>Four badge styles (data by / source / according to / powered by) in HTML, Markdown, JSON and SVG at /developers/attribution/ and/data/badges.json.
Start from a template
Five runnable starters in harpd-ai-datasets/templates — fork, install, run.
A Flask dashboard that plots Harpd Rank from the published JSON.
streamlit-explorerAn interactive Streamlit explorer over the category boards.
nextjs-ai-directoryA Next.js directory fed live by the Harpd AI Agent Index.
duckdb-analysisAnalytical SQL over the public datasets via DuckDB.
ai-agent-exampleA minimal AI agent that answers questions from Harpd data.
Register your adoption
Built something on Harpd? Tell us where, and we'll verify it and list it on the adoption registry. Registration only logs your submission — it never appears publicly until a human verifies it, so the registry stays free of fabricated entries.
Why it matters
Adoption is the middle of the chain: Harpd Data → Research → External Adoption → External Links → AI Retrieval → AI Citation. Every copy-paste surface here is designed to lower the cost of a third party genuinely using the data, because genuine use is what produces the external links and citations Harpd cannot create for itself.
Limitations
- Public data reflects products submitted to Harpd Rank; it maps this platform’s coverage, not the entire software market.
- Rank Points are promotional placement, not an editorial quality score — attribute them as such.
- The registry lists only verified adoptions; self-registration logs but does not publish.
Data source: Harpd external adoption