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.
Snapshots are versions of company profile information over time. These go back as far as Harmonic has been ingesting that particular company, which means they often have fewer datapoints than Traction Metrics.
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
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. These snapshots are taken at least every two weeks for companies that are relevant to our customers.
These snapshots can be pulled via GraphQL as well as the following REST endpoints: Enrich a Company, Get Company Saved Search Results, Get Company by ID, Get Companies by ID, and Batch Get Companies by ID.
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.