> For the complete documentation index, see [llms.txt](https://docs.coresignal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coresignal.com/company-data/bundles/core.md).

# Core Company Data Bundle

Core company bundle – field-level reference for company identity, firmographics, web presence, classification, location, contacts, and related company profiles.

The Core Company bundle forms the identity layer for each company record. It includes the company name, web presence, classification, size, location, and relationships to related pages. View the subcategories and their related data fields below.

* [Firmographics and identifiers](#firmographics-and-identifiers)
* [Websites and social links](#websites-and-social-links)
* [Company classification and descriptions](#company-classification-and-descriptions)
* [Size and status](#size-and-status)
* [Location](#location)
* [Contacts, reach, and metadata](#contacts-reach-and-metadata)
* [Related pages and people](#related-pages-and-people)

***

## Firmographics and identifiers

<table data-search="false"><thead><tr><th>Data field</th><th width="129.94921875">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>company_id</code></td><td>Integer</td><td>Company record identification key in our database</td><td><code>123456</code></td></tr><tr><td><code>source_id</code></td><td>String</td><td>Identifier assigned by Professional Network</td><td><code>abc123-source</code></td></tr><tr><td><code>is_deleted</code></td><td>Integer</td><td>Indicates whether the record is deleted:<br><code>1</code> – the profile returned "Page not found" or was deleted;<br><code>0</code> – the record is active</td><td><code>0</code></td></tr><tr><td><code>quality</code></td><td>Integer</td><td><p>Indicates record quality:</p><p><code>1</code> – the record meets all of the following:</p><ul><li>A company name is present;</li><li>Contains at least one indicator of identity: a website, company logo, or a non-zero number of employees;</li><li>The record has been updated recently enough to be considered current.</li></ul><p><code>0</code> – one or more of those checks failed</p></td><td><code>1</code></td></tr><tr><td><code>company_name</code></td><td>String</td><td>Company name</td><td><code>Example Company</code></td></tr><tr><td><code>company_name_alias</code></td><td>Array (string)</td><td>All name variations associated with the company</td><td><code>["Example Company Inc.", "Example Co."]</code></td></tr><tr><td><code>company_legal_name</code></td><td>String</td><td>Legal company name</td><td><code>Example Company Inc.</code></td></tr><tr><td><code>company_logo</code></td><td>String</td><td>The URL of company's logo</td><td><code>https://www.example.com/logo.png</code></td></tr><tr><td><code>company_logo_url</code></td><td>String</td><td>Logo URL (available from Professional Network only)</td><td><code>https://www.professional-network.com/logo.png</code></td></tr></tbody></table>

## Websites and social links

<table data-search="false"><thead><tr><th>Data field</th><th width="130.43359375">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>website</code></td><td>String</td><td>Website URL</td><td><code>https://www.examplecompany.com</code></td></tr><tr><td><code>website_domain</code></td><td>String</td><td>Normalized domain output</td><td><code>examplecompany.com</code></td></tr><tr><td><code>website_alias</code></td><td>Array (string)</td><td>All possible company website variations, collected from firmographic sources</td><td><code>["http://www.example.co", "https://www.examplecompany.io"]</code></td></tr><tr><td><code>professional_network_url</code></td><td>String</td><td>Professional network URL where the company was first discovered; can be outdated if the company has changed its profile</td><td><code>https://www.professional-network.com/company/examplecompany</code></td></tr><tr><td><code>professional_network_shorthand_name</code></td><td>String</td><td>Shorthand name of the company's Professional network URL</td><td><code>examplecompany</code></td></tr><tr><td><code>canonical_professional_network_url</code></td><td>String</td><td>The current official Professional network URL for the company, reflecting the most recent updates</td><td><code>https://www.professional-network.com/company/examplecompany</code></td></tr><tr><td><code>canonical_professional_network_shorthand_name</code></td><td>String</td><td>The current shorthand name of the company's Professional network URL</td><td><code>examplecompany</code></td></tr><tr><td><code>professional_network_shorthand_names</code></td><td>Array (string)</td><td>Historical variations of shorthand names for the company</td><td><code>["example-company", "exampleco", "example-co"]</code></td></tr><tr><td><code>twitter_url</code></td><td>Array (string)</td><td>Twitter profile URL</td><td><code>["https://twitter.com/exampleco"]</code></td></tr><tr><td><code>discord_url</code></td><td>Array (string)</td><td>Discord server URL</td><td><code>["https://discord.gg/example"]</code></td></tr><tr><td><code>facebook_url</code></td><td>Array (string)</td><td>Facebook page URL</td><td><code>["https://facebook.com/examplecompany"]</code></td></tr><tr><td><code>instagram_url</code></td><td>Array (string)</td><td>Instagram profile URL</td><td><code>["https://instagram.com/example.co"]</code></td></tr><tr><td><code>pinterest_url</code></td><td>Array (string)</td><td>Pinterest profile URL</td><td><code>["https://pinterest.com/examplecompany/"]</code></td></tr><tr><td><code>tiktok_url</code></td><td>Array (string)</td><td>TikTok profile URL</td><td><code>["https://www.tiktok.com/@examplecompany"]</code></td></tr><tr><td><code>youtube_url</code></td><td>Array (string)</td><td>YouTube channel URL</td><td><code>["https://youtube.com/examplecompany"]</code></td></tr><tr><td><code>github_url</code></td><td>Array (string)</td><td>GitHub profile URL</td><td><code>["https://github.com/exampleco"]</code></td></tr><tr><td><code>reddit_url</code></td><td>Array (string)</td><td>Reddit profile URL</td><td><code>["https://reddit.com/r/examplecompany"]</code></td></tr><tr><td><code>financial_website_url</code></td><td>String</td><td>Financial network profile URL</td><td><code>https://www.financial-website.com/organization/example-company</code></td></tr><tr><td><code>expired_domain</code></td><td>Integer</td><td>Indicates if the domain is expired</td><td><code>0</code></td></tr><tr><td><code>unique_domain</code></td><td>Integer</td><td>Indicates if the domain is unique</td><td><code>1</code></td></tr><tr><td><code>unique_website</code></td><td>Integer</td><td>Indicates if the website is unique</td><td><code>1</code></td></tr></tbody></table>

## Company classification and descriptions

<table data-search="false"><thead><tr><th>Data field</th><th width="130.26953125">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>is_b2b</code></td><td>Integer</td><td>Indicates if the company operates in a business-to-business model</td><td><code>1</code></td></tr><tr><td><code>business_areas</code></td><td>Array (string)</td><td>Mid-level areas the company operates in, e.g. what the company does</td><td><code>["Business Consulting", "Accounting and Tax Services"]</code></td></tr><tr><td><code>offerings</code></td><td>Array (string)</td><td>Concrete products and services the company sells; brand, product, and feature names are excluded</td><td><code>["Business Consulting Services", "Accounting Advisory Services", "Recruitment and Selection Services"]</code></td></tr><tr><td><code>is_saas</code></td><td>Boolean</td><td>Whether the company is a SaaS company</td><td><code>true</code></td></tr><tr><td><code>business_model</code></td><td>Array (string)</td><td>Business model(s) the company operates in</td><td><code>["B2B"]</code></td></tr><tr><td><code>industry</code></td><td>String</td><td>Company's industry</td><td><code>Software Development</code></td></tr><tr><td><code>sic_codes</code></td><td>Array (string)</td><td>Company's SIC codes</td><td><code>["7371", "7372"]</code></td></tr><tr><td><code>naics_codes</code></td><td>Array (string)</td><td>Company's NAICS codes</td><td><code>["541511", "541512"]</code></td></tr><tr><td><code>categories_and_keywords</code></td><td>Array (string)</td><td>Categories and keywords assigned to the company profile and products</td><td><code>["AI", "SaaS", "Developer Tools", "Machine Learning"]</code></td></tr><tr><td><code>description</code></td><td>String</td><td>Company description</td><td><code>Example Company builds smart software tools that help businesses automate and scale their workflows.</code></td></tr><tr><td><code>description_enriched</code></td><td>String</td><td>Company description, enriched with LLM</td><td><code>Example Company is a leading provider of cloud-native SaaS tools that combine machine learning and automation to help organizations optimize operations and reduce overhead.</code></td></tr><tr><td><code>description_metadata_raw</code></td><td>String</td><td>Company description parsed from external sources not included in our firmographic data</td><td><code>Founded in 2015, Example Company is a fast-growing B2B software company specializing in automation platforms.</code></td></tr><tr><td><code>tagline</code></td><td>String</td><td>Company tagline/headline as displayed on Professional network</td><td><code>Empowering Enterprises Through Innovation</code></td></tr><tr><td><code>type</code></td><td>String</td><td>Company type</td><td><code>Private</code></td></tr></tbody></table>

## Size and status

<table><thead><tr><th>Data field</th><th width="130.01953125">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>status</code></td><td>Struct</td><td>Operational and ownership status</td><td><code>{ "value": "Active", "comment": "Acquired" }</code></td></tr><tr><td><code>status.value</code></td><td>String</td><td>Current operational status</td><td><code>Active</code></td></tr><tr><td><code>status.comment</code></td><td>String</td><td>Current ownership status</td><td><code>Acquired</code></td></tr><tr><td><code>founded_year</code></td><td>String</td><td>Founding year</td><td><code>2015</code></td></tr><tr><td><code>size_range</code></td><td>String</td><td>Company size based on employee count range, as selected by the company profile administrator</td><td><code>501-1000 employees</code></td></tr><tr><td><code>employees_count</code></td><td>Integer</td><td>Number of employees on Professional Network who associated their experience with the company</td><td><code>548</code></td></tr></tbody></table>

## Location

<table data-search="false"><thead><tr><th>Data field</th><th width="129.7265625">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>hq_region</code></td><td>Array (string)</td><td>Region of the company's HQ location</td><td><code>["Americas", "Northern America", "AMER"]</code></td></tr><tr><td><code>hq_country</code></td><td>String</td><td>Country where the company's headquarters is located</td><td><code>United States</code></td></tr><tr><td><code>hq_country_iso2</code></td><td>String</td><td>ISO 2-letter code of the headquarters country</td><td><code>US</code></td></tr><tr><td><code>hq_country_iso3</code></td><td>String</td><td>ISO 3-letter code of the headquarters country</td><td><code>USA</code></td></tr><tr><td><code>hq_location</code></td><td>String</td><td>Headquarters location</td><td><code>Austin, TX, United States</code></td></tr><tr><td><code>hq_full_address</code></td><td>String</td><td>Full address of the headquarters</td><td><code>123 Main Street; Suite 500; Austin, TX 78701, US</code></td></tr><tr><td><code>hq_city</code></td><td>String</td><td>Headquarters city; data available only for US companies</td><td><code>Austin</code></td></tr><tr><td><code>hq_state</code></td><td>String</td><td>Headquarters state; data available only for US companies</td><td><code>Texas</code></td></tr><tr><td><code>hq_street</code></td><td>String</td><td>Headquarters street address</td><td><code>123 Main Street; Suite 500</code></td></tr><tr><td><code>hq_zipcode</code></td><td>String</td><td>Headquarters zip code</td><td><code>78701</code></td></tr><tr><td><code>hq_latitude</code></td><td>Float (double)</td><td>Geographic latitude coordinate of the company's headquarters</td><td><code>30.266666</code></td></tr><tr><td><code>hq_longitude</code></td><td>Float (double)</td><td>Geographic longitude coordinate of the company's headquarters</td><td><code>-97.733330</code></td></tr><tr><td><code>hq_apartment</code></td><td>String</td><td>Apartment number or unit identifier for the headquarters</td><td><code>Suite 500</code></td></tr><tr><td><code>hq_suite</code></td><td>String</td><td>Suite number or office designator for the headquarters</td><td><code>Suite 500</code></td></tr><tr><td><code>company_locations_full</code></td><td>Array (struct)</td><td>Company locations list</td><td><code>[ { "location_address": "123 Main Street; Suite 500; Austin, TX 78701, US", "is_primary": true, "country": "United States", "country_iso_2": "US", "country_iso_3": "USA", "regions": [ "Americas", "Northern America", "AMER" ], "city": "Austin", "state": "Texas", "street": "123 Main Street", "zip_code": "78701", "latitude": 30.266666, "longitude": -97.733330 } ]</code></td></tr><tr><td><code>company_locations_full[].location_address</code></td><td>String</td><td>Company location address</td><td><code>123 Main Street; Suite 500; Austin, TX 78701, US</code></td></tr><tr><td><code>company_locations_full[].is_primary</code></td><td>Integer</td><td>Indicates if this is the primary company location</td><td><code>1</code></td></tr><tr><td><code>company_locations_full[].country</code></td><td>String</td><td>Location country</td><td><code>United States</code></td></tr><tr><td><code>company_locations_full[].country_iso_2</code></td><td>String</td><td>ISO 2-letter code of the country</td><td><code>US</code></td></tr><tr><td><code>company_locations_full[].country_iso_3</code></td><td>String</td><td>ISO 3-letter code of the country</td><td><code>USA</code></td></tr><tr><td><code>company_locations_full[].regions</code></td><td>Array (string)</td><td>Location regions</td><td><code>["Americas", "Northern America", "AMER"]</code></td></tr><tr><td><code>company_locations_full[].city</code></td><td>String</td><td>City name of the company location</td><td><code>Austin</code></td></tr><tr><td><code>company_locations_full[].state</code></td><td>String</td><td>State of the company location</td><td><code>Texas</code></td></tr><tr><td><code>company_locations_full[].street</code></td><td>String</td><td>Street address of the company location</td><td><code>123 Main Street</code></td></tr><tr><td><code>company_locations_full[].zip_code</code></td><td>String</td><td>Postal or ZIP code of the company location</td><td><code>78701</code></td></tr><tr><td><code>company_locations_full[].latitude</code></td><td>Float (double)</td><td>Geographic latitude coordinate of the company location</td><td><code>30.266666</code></td></tr><tr><td><code>company_locations_full[].longitude</code></td><td>Float (double)</td><td>Geographic longitude coordinate of the company location</td><td><code>-97.733330</code></td></tr></tbody></table>

## Contacts, reach, and metadata

<table data-search="false"><thead><tr><th>Data field</th><th width="129.91796875">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>followers_count_professional_network</code></td><td>Integer</td><td>Profile follower count on professional network</td><td><code>23700</code></td></tr><tr><td><code>followers_count_twitter</code></td><td>Integer (long)</td><td>Profile follower count on Twitter</td><td><code>12800</code></td></tr><tr><td><code>followers_count_owler</code></td><td>Integer (long)</td><td>Profile follower count on Owler</td><td><code>5400</code></td></tr><tr><td><code>company_phone_numbers</code></td><td>Array (string)</td><td>Public phone numbers</td><td><code>["(555) 123-4567"]</code></td></tr><tr><td><code>company_emails</code></td><td>Array (string)</td><td>Public email addresses</td><td><code>["info@examplecompany.com", "support@examplecompany.com"]</code></td></tr><tr><td><code>last_updated_at</code></td><td>String</td><td>Last update date of the record, in <code>YYYY-MM-DD</code> format</td><td><code>2026-03-01</code></td></tr><tr><td><code>created_at</code></td><td>String</td><td>Record creation date, in <code>YYYY-MM-DD</code> format</td><td><code>2025-01-15</code></td></tr></tbody></table>

## Related pages and people

<table data-search="false"><thead><tr><th>Data field</th><th width="129.82421875">Data type</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>similar_pages</code></td><td>Array (struct)</td><td>Companies similar to the record company</td><td><code>[{ "id": "bbe56789012dd45f9123d4567891234ca", "name": "Partner Company", "industry": "Software Development", "url": "https://www.professional-network.com/company/partner-company", "location": "New York, New York, United States" }]</code></td></tr><tr><td><code>similar_pages[].id</code></td><td>String</td><td>Identification key for the similar company record</td><td><code>bbe56789012dd45f9123d4567891234ca</code></td></tr><tr><td><code>similar_pages[].name</code></td><td>String</td><td>Similar company name</td><td><code>Partner Company</code></td></tr><tr><td><code>similar_pages[].industry</code></td><td>String</td><td>Similar company industry</td><td><code>Software Development</code></td></tr><tr><td><code>similar_pages[].url</code></td><td>String</td><td>Similar company profile URL</td><td><code>https://www.professional-network.com/company/partner-company</code></td></tr><tr><td><code>similar_pages[].location</code></td><td>String</td><td>Similar company location</td><td><code>New York, New York, United States</code></td></tr><tr><td><code>featured_employees</code></td><td>Array (struct)</td><td>List of featured employees</td><td><code>[{ "id": "fa56c2a89fcfede8f12e10c78901c3c9", "full_name": "John Doe", "headline": "CEO &#x26; Co-Founder at Example Company", "profile_url": "https://www.professional-network.com/john-doe-12345" }]</code></td></tr><tr><td><code>featured_employees[].id</code></td><td>String</td><td>Identification key for the employee record</td><td><code>fa56c2a89fcfede8f12e10c78901c3c9</code></td></tr><tr><td><code>featured_employees[].full_name</code></td><td>String</td><td>Employee full name</td><td><code>John Doe</code></td></tr><tr><td><code>featured_employees[].headline</code></td><td>String</td><td>Employee profile headline</td><td><code>CEO &#x26; Co-Founder at Example Company</code></td></tr><tr><td><code>featured_employees[].profile_url</code></td><td>String</td><td>Employee profile URL</td><td><code>https://www.professional-network.com/john-doe-12345</code></td></tr><tr><td><code>affiliated_pages</code></td><td>Array (struct)</td><td>Profiles of affiliated companies</td><td><code>[{ "id": "94e5cb6f34a2df456d78a23b56adc678", "affiliated_company_id": 1000001, "url": "https://www.professional-network.com/company/example-company-europe", "name": "Example Company Europe", "location": "Amsterdam, Netherlands", "industry": "Software Development" }]</code></td></tr><tr><td><code>affiliated_pages[].id</code></td><td>String</td><td>Identification key for the affiliated company record</td><td><code>94e5cb6f34a2df456d78a23b56adc678</code></td></tr><tr><td><code>affiliated_pages[].affiliated_company_id</code></td><td>Integer</td><td>Identification key relating to the company table for the affiliate</td><td><code>1000001</code></td></tr><tr><td><code>affiliated_pages[].url</code></td><td>String</td><td>Affiliate company profile URL</td><td><code>https://www.professional-network.com/company/example-company-europe</code></td></tr><tr><td><code>affiliated_pages[].name</code></td><td>String</td><td>Affiliate company name</td><td><code>Example Company Europe</code></td></tr><tr><td><code>affiliated_pages[].location</code></td><td>String</td><td>Affiliate company location</td><td><code>Amsterdam, Netherlands</code></td></tr><tr><td><code>affiliated_pages[].industry</code></td><td>String</td><td>Affiliate company industry</td><td><code>Software Development</code></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coresignal.com/company-data/bundles/core.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.