Embed
Harpd embed directory
Every widget is a sandboxed iframe pointing at a Harpd page, so the data can never drift from the canonical board and no third-party script is injected into your page. Each row below carries the snippet, the dataset behind it, how often it updates and the API endpoint that serves the same rows if you would rather render them yourself.
All Harpd data is published under CC BY 4.0: reuse is allowed, attribution is required, and every widget renders a Powered by Harpd link. Full terms:attribution contract.
Rank Board
Use case
Show a live Harpd leaderboard on a directory, newsletter or blog post.
Snippet
<script src="https://harpd.com/embed/rank.js" data-limit="10" data-theme="auto" async></script>Provenance
- Data source
- Harpd Rank (overall or one category)
- Update cadence
- Served live from the board; edge-cached 5 minutes.
- Licence
- CC BY 4.0 (attribution required)
- Dataset
- /data/rank.json
Category Board
Use case
Narrow the board to one category — e.g. an AI agents page that only shows agents.
Snippet
<script src="https://harpd.com/embed/category.js" data-category="agents" data-limit="10" async></script>data-category is required. Known slugs: seo, agents, ai-media, marketing, developer, productivity, people, design, social, writing, sales, business, games, education, health, ecommerce, directories, hiring, audio, crypto, agencies, security, travel, news, domains, leaderboards, real-estate, other.
Provenance
- Data source
- Harpd Rank, scoped to one category
- Update cadence
- Served live from the board; edge-cached 5 minutes.
- Licence
- CC BY 4.0 (attribution required)
- Dataset
- /data/categories.json
Research Snapshot
Use case
Quote a closed-month research finding with its period, method and citation URL attached.
Snippet
<script src="https://harpd.com/embed/research.js" data-family="ai-agent-index" async></script>Provenance
- Data source
- Harpd Research (closed monthly snapshots)
- Update cadence
- Immutable once a UTC month closes; a new report appears monthly.
- Licence
- CC BY 4.0 (attribution required)
- Dataset
- /data/research.json
Dataset Table
Use case
Show a dataset with its schema version, licence, methodology and last update — the provenance a reader needs before reusing a number.
Snippet
<script src="https://harpd.com/embed/dataset.js" data-dataset="rank" data-limit="10" async></script>Known dataset ids: rank, categories, products, research, citations, claims.
Provenance
- Data source
- Harpd open data catalogue
- Update cadence
- Edge-cached 5 minutes; last record update shown in the widget footer.
- Licence
- CC BY 4.0 (attribution required)
- Dataset
- /data/
Verified badges
Use case
A static "Data by Harpd" badge for an article or README that cites Harpd figures.
Snippet
<img src="https://harpd.com/embed/badge/data-by-harpd.svg" alt="Data by Harpd" width="120" height="20">Provenance
- Data source
- Static SVG — no live data
- Update cadence
- Static.
- Licence
- CC BY 4.0 (attribution required)
- Dataset
- /developers/attribution/
Options
| Attribute | Default | What it does |
|---|---|---|
data-category | overall | A Harpd category slug, e.g. agents, developer, seo. |
data-limit | 10 | Rows to render. Clamped to 1–50. |
data-theme | auto | light, dark, or auto (follows the host page's colour scheme). |
data-points | on | Set 0 to hide the Rank Points column. |
data-family / data-month | latest | Research snapshots only: pick a family and a closed month key. |
data-dataset | catalogue | Dataset tables only: pick one dataset id. |
What the data means
Harpd Rank is a discovery and promotional placement board, not an independent editorial quality score. Listing is free; 1 Credit = 1 Rank Point, and Rank Points determine board position. No widget hides that — every copy carries the disclosure line, and the API repeats it in every response. Full rules: /rank/rules/ · Methodology:/rank/methodology/.
Want the numbers without a widget? The same data is published as JSON and CSV at/data/, and the embed API is documented at/developers/embed/.