Data by Harpd
You used Harpd data in a chart, table or analysis and want to credit the source.
HTML
Markdown
JSON
SVG URL
Attribution contract
Harpd attribution contract
Quick answer
What attribution does Harpd require?
Harpd data is released under CC BY 4.0. If you render Harpd data, you must attribute Harpd, hyperlink to the canonical Harpd URL for that data, keep its data date visible, and not present Rank Points as a quality score. Four official badges are provided in HTML, Markdown, JSON and SVG form; each already carries the licence and links to the canonical source.
- Licence
- CC BY 4.0
- Official badges
- 4
- Machine-readable
- /data/badges.json
Data source: Harpd attribution contract — first-partyBadge JSONCitation policy
What the contract requires
Five requirements, each independently checkable. An embed that satisfies all five is compliant withCC BY 4.0 and with Harpd's attribution terms.
| Requirement | What it means |
|---|---|
| Link back to the canonical Harpd URL | The embed must hyperlink to the specific Harpd page for the data it shows — /data/ for datasets, /rank/ for board positions, /research/ for report figures. Never a tracking redirect or a mirror. |
| Keep the data date visible | Harpd figures carry the data date of the dataset behind them. If your embed renders a number, render the date with it. |
| Do not imply Harpd endorsement | Badges credit the data source. They must not be presented as a rating, certification, review or partnership. |
| Do not present Rank Points as quality | Rank Points are paid promotional placement. An embed showing Rank Points must not label them as a quality, performance or review score. |
| State the licence | CC BY 4.0 with attribution to Harpd. The badge alt text and the JSON descriptor both carry this, so linking the badge is sufficient. |
Official badges
Each badge is generated from one definition, so the image, the alt text, the Markdown and the JSON descriptor always agree. Append ?theme=dark to the SVG URL for the dark-background variant. All four are also available machine-readably at /data/badges.json.
Source: Harpd
A figure, ranking position or category count in your article comes from Harpd.
HTML
Markdown
JSON
SVG URL
According to Harpd
You are quoting a Harpd research report or a statement Harpd published.
HTML
Markdown
JSON
SVG URL
Powered by Harpd Open Data
Your tool, site or dataset consumes the Harpd public API or an open dataset at runtime.
HTML
Markdown
JSON
SVG URL
Consuming Harpd data
Every public Harpd dataset is read-only and needs no key or signup. These examples fetch the ranking dataset and print its size; the attribution comment is the part the contract requires you to keep.
curl
curl -s https://harpd.com/data/rank.json | jq '.products | length'JavaScript
const rank = await fetch('https://harpd.com/data/rank.json').then((r) => r.json())
// Attribution is required when you render this data:
// "Data by Harpd" -> https://harpd.com/data/ (CC BY 4.0)Python
import urllib.request, json
rank = json.load(urllib.request.urlopen("https://harpd.com/data/rank.json"))
# Attribution is required when you render this data:
# "Data by Harpd" -> https://harpd.com/data/ (CC BY 4.0)Endpoint reference: /developers/api/. Dataset index:/data/. Interactive embed generator (widgets, not badges):/developers/embed/.