Overview
Traction Metrics are granular data points that go back as far as we can find data on a given company. They are the most complete source of data to reference.
⚠️ Note: Snapshots have been deprecated as of March 2026 and are no longer available in bulk data share or updated via API. If you have existing workflows using snapshots, migrate to traction_metrics. See the Traction Metrics section below.
Traction Metrics
Traction Metrics are granular values for team headcount, headcount by department, social media followers, and funding information. Each area has both predefined interval values as well as detailed historic values.
The predefined intervals are 14, 30, 90, 180, and 365 days ago. Each interval has the value, the incremental change, and the percent change from that period.
"headcount": {
"14d_ago": {
"value": null,
"change": null,
"percent_change": null
},
"30d_ago": {
"value": null,
"change": null,
"percent_change": null
},
"90d_ago": {
"value": null,
"change": null,
"percent_change": null
},
"180d_ago": {
"value": null,
"change": null,
"percent_change": null
},
"365d_ago": {
"value": null,
"change": null,
"percent_change": null
},
For detailed historic values use the metrics field within traction_metrics. This will have every historic value as well as the corresponding timestamp.
"metrics": [
{
"timestamp": "2021-12-05T08:11:36.508000+00:00",
"metric_value": 50
},
{
"timestamp": "2021-11-21T05:22:57.534000+00:00",
"metric_value": 48
},
]
Snapshots (deprecated)
This field has been deprecated as of March 2026 and is no longer updated. Kept here for reference only.
Snapshots are slices of company profiles in time series which allow you to retrieve information about the company from the past such as headcount, funding information, links, description, and more.
Example Structure:
"snapshots": [
{
"initialized_date": "2020-10-27T08:07:19.940106",
"website": {...},
"website_domain_aliases": [...],
"logo_url": "string",
"name": "string",
"name_aliases": [...],
"legal_name": "string",
"description": "string",
"founding_date": {...},
"headcount": 0,
"ownership_status": "PRIVATE",
"company_type": "UNKNOWN",
"customer_type": "B2C",
"location": {...},
"contact": {...},
"socials": {...},
"funding": {...},
"entity_urn": "urn:harmonic:company:123456",
"funding_attribute_null_status": "EXISTS_BUT_UNDISCLOSED",
}
]
Note: Harmonic typically uses the phrase "Initialized Date" to mean the date when a company was first ingested into our database. However, within Snapshots the term is used to mean the date that the snapshot was taken.