This guide provides a comprehensive overview of the fields available in the Harmonic API for both companies and people lists. Each field is accessible via its corresponding URN (Uniform Resource Name) when using our API endpoints.
Company Fields
The following fields are available when working with company lists through the Harmonic API:
Basic information
Display Name | Field URN | Description |
ID |
| Unique identifier for the company |
Date added to Harmonic |
| Date when the company was first added to Harmonic's database |
Date added |
| Date when the company was added to a list |
Added by |
| User who added the company to a list |
Updated date |
| Date when the company information was last updated |
Name |
| Company name |
Legal name |
| Legal company name |
Relevance score |
| Calculated relevance score |
Company highlights |
| Key highlights about the company |
Description |
| Company description |
External description |
| Company description from external sources |
Team
Display Name | Field URN | Description |
Team |
| Information about the company's team |
Founders & CEOs |
| Information about founders and CEOs |
Executives |
| Information about company executives |
Leadership's prior experiences |
| Previous companies of leadership team members |
Team network |
| Network connections of team members |
Team LinkedIn profiles |
| LinkedIn profiles of team members |
Engagement (network connections)
Display Name | Field URN | Description |
Last meeting date |
| Date of last meeting with this company |
Last meeting with |
| Person who had the last meeting with this company |
Last email date |
| Date of last email with this company |
Last email with |
| Person who had the last email with this company |
Affinity lists |
| Affinity lists containing this company |
Lists |
| Lists containing this company |
Company demographics
Display Name | Field URN | Description |
Headcount |
| Total employee count |
External headcount |
| Headcount from external sources |
City |
| Company's city location |
State |
| Company's state location |
Country |
| Company's country location |
Founding date |
| Date when the company was founded |
Tags |
| Tags associated with the company |
Company type |
| Type of company (e.g., Private, Public) |
Web
Display Name | Field URN | Description |
Website |
| Company website URL |
| Company LinkedIn URL | |
| Company Twitter URL | |
Twitter handle |
| Company Twitter handle |
Crunchbase |
| Company Crunchbase URL |
Pitchbook |
| Company Pitchbook URL |
| Company Instagram URL | |
| Company Facebook URL | |
AngelList |
| Company AngelList URL |
Indeed |
| Company Indeed URL |
YouTube |
| Company YouTube URL |
Monster |
| Company Monster URL |
StackOverflow |
| Company StackOverflow URL |
Social following
Display Name | Field URN | Description |
LinkedIn followers |
| Number of LinkedIn followers |
Twitter followers |
| Number of Twitter followers |
Instagram followers |
| Number of Instagram followers |
Contact information
Display Name | Field URN | Description |
Company emails |
| Company email addresses |
Team emails |
| Email addresses of team members |
Phone number |
| Company phone numbers |
Funding information
Display Name | Field URN | Description |
Stage |
| Company funding stage |
# Funding rounds |
| Number of funding rounds |
Last funding date |
| Date of last funding round |
Last funding type |
| Type of last funding round |
Last funding round total |
| Amount raised in last funding round |
Funding total |
| Total funding raised |
Funding per employee |
| Funding amount per employee |
Investors |
| Names of investors |
Tags
Display Name | Field URN | Description |
Customer type |
| Type of customers (B2B, B2C, etc.) |
Industry tags |
| Industry categories |
Technology tags |
| Technologies used by the company |
Accelerators |
| Accelerator programs the company participated in |
Headcount trends
Similar fields are available for 30d, 90d, 180d, and 365d periods
Display Name | Field URN | Description |
Headcount (14d) |
| Headcount 14 days ago |
Headcount ∆ (14d) |
| Absolute headcount change in last 14 days |
Headcount % (14d) |
| Percentage headcount change in last 14 days |
e.g. To access headcount values for different time periods, swap the time indicator in the URN. For example, to change from 14-day to 90-day value, change company_headcount_value_14d_ago
to company_headcount_value_90d_ago
. The same pattern applies for change metrics (real_change
) and percentage metrics (percent_change
).
Department Headcount
Harmonic provides department-specific headcount metrics for the following departments:
Advisor
Customer Success
Data
Design
Engineering
Finance
Legal
Marketing
Operations
People
Product
Sales
Support
Other
For each department, the following metrics are available with 14d, 30d, 90d, 180d, and 365d time periods:
Current headcount
Absolute change (∆)
Percentage change (%)
Example for Engineering department:
Display Name | Field URN | Description |
Headcount (Engineering) |
| Current engineering headcount |
Headcount (Engineering) (14d) |
| Engineering headcount 14 days ago |
Headcount (Engineering) ∆ (14d) |
| Absolute engineering headcount change in last 14 days |
Headcount (Engineering) % (14d) |
| Percentage engineering headcount change in last 14 days |
Similar fields are available for 30d, 90d, 180d, and 365d periods
e.g. To access different department headcount values, replace the department name in the URN. For example, to switch from Engineering to Marketing, change company_headcount_engineering_value_14d_ago
to company_headcount_marketing_value_14d_ago
. The same pattern applies for change metrics and percentage metrics.
Web traffic metrics
Display Name | Field URN | Description |
Web traffic |
| Current web traffic data |
Web traffic (30d) |
| Web traffic 30 days ago |
Web traffic ∆ (30d) |
| Absolute web traffic change in last 30 days |
Web traffic % (30d) |
| Percentage web traffic change in last 30 days |
Similar fields are available for 90d, 180d, and 365d periods
e.g. For web traffic values over different periods, swap the time indicator in the URN. For example, to change from 30-day to 180-day web traffic value, replace company_web_traffic_value_30d_ago
with company_web_traffic_value_180d_ago
. The same pattern applies for change metrics and percentage metrics.
Social metrics
Similar to headcount and web traffic, detailed trend metrics are available for:
Twitter followers
LinkedIn followers
Facebook likes
Instagram followers
Each with 14d, 30d, 90d, 180d, and 365d trend data.
Display Name | Field URN | Description |
Twitter followers (14d) |
| Twitter followers 14 days ago |
Twitter followers ∆ (14d) |
| Absolute Twitter followers change in last 14 days |
Twitter followers % (14d) |
| Percentage Twitter followers change in last 14 days |
e.g. To get different social platform metrics, replace the platform name and time period. For example, to switch from Twitter to LinkedIn follower counts, change company_twitter_follower_count_value_14d_ago
to company_linkedin_follower_count_value_14d_ago
. The same pattern applies for change metrics and percentage metrics.
Notes
Display Name | Field URN | Description |
My notes |
| User's personal notes about the company |
Team notes |
| Team's shared notes about the company |
People Fields
The following fields are available when working with people data through the Harmonic API:
Basic information
Display Name | Field URN | Description |
ID |
| Unique identifier for the person |
Date added |
| Date when the person was added to a list |
Added by |
| User who added the person to a list |
Full name |
| Person's full name |
First name |
| Person's first name |
Last name |
| Person's last name |
Lists |
| Lists containing this person |
Professional information
Display Name |
| Description |
Current company |
| ID of current employer |
Person highlights |
| Key highlights about the person |
Current title |
| Current job title |
Current department |
| Current department |
Current location |
| Current location |
LinkedIn headline |
| LinkedIn headline |
Current company tags |
| Tags of current company |
Employment history
Display Name | Field URN | Description |
Previous company |
| ID of previous employer |
Previous company tags |
| Tags of previous company |
Education |
| Educational institutions attended |
Previous companies |
| IDs of previous employers |
Contact
Display Name | Field URN | Description |
| LinkedIn profile URL | |
Emails |
| Email addresses |
Engagement (Network Connections)
Display Name | Field URN | Description |
Team network |
| Network connections with team members |
Last meeting date |
| Date of last meeting with this person |
Last meeting with |
| Team member who had the last meeting with this person |
Last email date |
| Date of last email with this person |
Last email with |
| Team member who had the last email with this person |