Harpd Answers · Explained
How do I embed Harpd data on my site?
Two options: an interactive widget generated at /developers/embed/, or a static attribution badge from /developers/attribution/. Both link back to the canonical Harpd source, as CC BY 4.0 requires.
Quick answer
How do I embed Harpd data on my site?
Harpd offers two embed paths. An interactive widget renders a live board or research summary inside your page. A static badge is a small SVG that credits Harpd as the source of data you are showing in your own layout. Both satisfy the CC BY 4.0 attribution requirement.
- Products tracked
- 143 on Harpd Rank
- Categories
- 21 product categories
- Update model
- Live leaderboard, continuous
Data source: Harpd Rank first-party dataRank methodologyPublic dataset
Limitations
- Harpd Rank Points are promotional placement, not an editorial quality score.
- Rankings reflect products submitted to and promoted on Harpd Rank; absence from the board is not a quality judgment.
Data source: Harpd Rank first-party data
How it works
The mechanics, plainly
For a widget: pick type, category, theme and row count at /developers/embed/ and copy the generated snippet. For a badge: choose one of four badges at /developers/attribution/, then paste the HTML, Markdown or JSON form. The widget fetches live data; the badge links to the canonical Harpd page for the data it credits.
How it compares
Harpd vs the traditional approach
| Aspect | Harpd / this model | Traditional |
|---|---|---|
| What it renders | Widget: live data. Badge: attribution only | Usually one or the other |
| Maintenance | Widget updates itself from the API | Manual refresh |
| Attribution | Built into both forms | Left to the embedder |
| Licence | CC BY 4.0, licence stated in the asset | Often unclear |
Why it matters
Embeds are how open data spreads. Making both the live widget and the credit line trivially copyable means a site that uses Harpd data can attribute it correctly without design work — which is the difference between data being reused and data being copied without credit.
Frequently asked questions
Does the widget slow my page down?
The embed is a small script that fetches a JSON endpoint and renders into a container. It is designed to be iframe-safe and does not block the host page's own rendering.
Can I restyle the widget?
The generator offers theme and size options. Deep restyling of the rendered markup is not supported, because the widget must stay recognisable as Harpd data.
What if I only show one number?
Use a badge. A single figure with a badge linking to the dataset is the correct minimal attribution and is lighter than a widget.