Best Practice: Legacy CSV Access via NDJSON

Article author
Erika
  • Updated

Crunchbase’s Legacy CSV Exports Details

Crunchbase has made significant improvements to our data offering including broader data coverage, new endpoints, AI-powered predictive company intelligence, and more.

To support these advancements and to ensure ongoing scalability and support, you are required to migrate your Legacy Crunchbase API Key and CSV plan to a new Crunchbase API Key. This update enables access to Crunchbase’s data quality improvements, enhanced ease-of-use, and ultimately a better support experience.

What’s Changed with Key Access?

Crunchbase has moved away from legacy API keys and introduced new packaging tiers based on access to Crunchbase’s proprietary company intelligence. If you’re a legacy customer, your new API key and CSV access has been provisioned to a package that reflects your current contract and level of access. 

This legacy method provides a daily snapshot of API fields without coding against the REST API

Exports are available in two formats:

NDJSON (Recommended) – preserves nested and complex JSON structures

CSV (Legacy Flat Format) – flattened tabular structure for spreadsheet-based workflows

Your API package determines which CSV files you can download. For more information on our different API packages, check out this page

The following table outlines which packages have access to our different CSV files:

Collection   Core/Advanced Firmographics Core Financials Advanced Financials Predictions & Insights
Acquisition Predictions
Acquisitions   
Addresses   
Awards 
Categories      
Category Groups   
Closure Predictions  
Competitors (Org_Similarity)                     ✔
Degrees   
Diversity Spotlights  
Event Appearances 
Events       
Funds  
Funding Predictions 
Funding Rounds 
Growth Insights   
Growth Predictions  
Investments    
Investor Insights   
IPO Predictions  
IPOs    
Jobs   
Key Employee Changes   
Layoffs  
Layoff Predictions 
Legal Proceedings 
Locations  
Organizations 
Ownerships
Partnership Announcements
People   
Press References   
Principals 
Products Insights    
Product Launches  
Research and Development (R&D)
Remain Private Predictions                     ✔

Accessing the NDJSON endpoints

NDJSON (Newline Delimited JSON) preserves nested and complex JSON structures without flattening relationships or losing data fidelity.

Each export is delivered as a compressed .zip file containing a .ndjson file. Each line in the file represents one valid JSON object (one record per line).

To access these NDJSON files with your new Crunchbase API key, follow these steps:

Reminder — Unlock your New API Key  Retrieve your new API key by logging in to Crunchbase. This is found within Account Settings > Integrations > Crunchbase API. As mentioned in the previous article, you’ll see your updated API package (the package will be reflective of your legacy plan’s access). Click “Show Key” to access your new API key. 

Enter URL Into Your Browser.  Once you’ve located your new API key, type the URL address corresponding to the file you wish to download into your browser, replacing "\<user_key>" with the value that you received.

Collection NDJSON URL
Acquisition Predictions https://api.crunchbase.com/v4/data/static_exports/acquisition_predictions.ndjson.zip?user_key=
Acquisitions https://api.crunchbase.com/v4/data/static_exports/acquisitions.ndjson.zip?user_key=
Addresses https://api.crunchbase.com/v4/data/static_exports/addresses.ndjson.zip?user_key=
Awards https://api.crunchbase.com/v4/data/static_exports/awards.ndjson.zip?user_key=
Categories https://api.crunchbase.com/v4/data/static_exports/categories.ndjson.zip?user_key=
Category Groups https://api.crunchbase.com/v4/data/static_exports/category_groups.ndjson.zip?user_key=
Closure Predictions https://api.crunchbase.com/v4/data/static_exports/closure_predictions.ndjson.zip?user_key=
Degrees https://api.crunchbase.com/v4/data/static_exports/degrees.ndjson.zip?user_key=
Diversity Spotlights https://api.crunchbase.com/v4/data/static_exports/diversity_spotlights.ndjson.zip?user_key=
Event Appearances https://api.crunchbase.com/v4/data/static_exports/event_appearances.ndjson.zip?user_key=
Events https://api.crunchbase.com/v4/data/static_exports/events.ndjson.zip?user_key=
Funds https://api.crunchbase.com/v4/data/static_exports/funds.ndjson.zip?user_key=
Funding Predictions https://api.crunchbase.com/v4/data/static_exports/funding_predictions.ndjson.zip?user_key=
Funding Rounds https://api.crunchbase.com/v4/data/static_exports/funding_rounds.ndjson.zip?user_key=
Growth Insights https://api.crunchbase.com/v4/data/static_exports/growth_insights.ndjson.zip?user_key=
Growth Predictions https://api.crunchbase.com/v4/data/static_exports/growth_predictions.ndjson.zip?user_key=
Investments https://api.crunchbase.com/v4/data/static_exports/investments.ndjson.zip?user_key=
Investor Insights https://api.crunchbase.com/v4/data/static_exports/investor_insights.ndjson.zip?user_key=
Investor Matches https://api.crunchbase.com/v4/data/static_exports/investor_matches.ndjson.zip?user_key=
IPO Predictions https://api.crunchbase.com/v4/data/static_exports/ipo_predictions.ndjson.zip?user_key=
IPOs https://api.crunchbase.com/v4/data/static_exports/ipos.ndjson.zip?user_key=
Jobs https://api.crunchbase.com/v4/data/static_exports/jobs.ndjson.zip?user_key=
Key Employee Changes https://api.crunchbase.com/v4/data/static_exports/key_employee_changes.ndjson.zip?user_key=
Layoffs https://api.crunchbase.com/v4/data/static_exports/layoffs.ndjson.zip?user_key=
Layoff Predictions https://api.crunchbase.com/v4/data/static_exports/layoff_predictions.ndjson.zip?user_key=
Legal Proceedings https://api.crunchbase.com/v4/data/static_exports/legal_proceedings.ndjson.zip?user_key=
Locations https://api.crunchbase.com/v4/data/static_exports/locations.ndjson.zip?user_key=
Organizations https://api.crunchbase.com/v4/data/static_exports/organizations.ndjson.zip?user_key=
Organizations Similarity (aka Competitors) https://api.crunchbase.com/v4/data/static_exports/org_similarity.ndjson.zip?user_key=
Ownerships https://api.crunchbase.com/v4/data/static_exports/ownerships.ndjson.zip?user_key=
Partnership Announcements https://api.crunchbase.com/v4/data/static_exports/partnership_announcements.ndjson.zip?user_key=
People https://api.crunchbase.com/v4/data/static_exports/people.ndjson.zip?user_key=
Press References https://api.crunchbase.com/v4/data/static_exports/press_references.ndjson.zip?user_key=
Principals https://api.crunchbase.com/v4/data/static_exports/principals.ndjson.zip?user_key=
Products Insights https://api.crunchbase.com/v4/data/static_exports/products.ndjson.zip?user_key=
Product Launches https://api.crunchbase.com/v4/data/static_exports/product_launches.ndjson.zip?user_key=
Research and Development (R&D) https://api.crunchbase.com/v4/data/static_exports/research_insights.ndjson.zip?user_key=
Remain Private Predictions https://api.crunchbase.com/v4/data/static_exports/remain_private_predictions.ndjson.zip?user_key=

 

Press Enter Key to Begin Download. Once the correct URL is in the address bar, press  “Enter” (or "Return") and the download should begin automatically.  If the download does not begin, please contact support.

Unzip the file. You will have downloaded a .zip file containing the NDJSON/CSV you've requested. Unzip the file to begin using the file.

CSVs Format & Encoding

Our CSVs are encoded in UTF-8 and followed the standard CSV format of:

  • escape character is "" (double quotes)
  • field delimiter is ',' (comma)
  • record delimiter is '\n' (new line)

This is a standard CSV format that should behave appropriately if opened with tools or libraries that are configured to the default CSV format listed above.

Understanding the CSV Export's Contents

As a snapshot of the contents of our API, each CSV contains the exact fields for every entity that exists for a given collection. This means that the documentation for a given API endpoint collection's fields correspond directly to each column for the matching CSV.

We recommend using our Data Dictionary to give you a picture of what fields are available.

Screenshot 2025-09-12 at 2.41.47 PM.png

By clicking on the Fields (API/CSV) tab, you can see a description of the available fields across all collections available in the API and CSV offerings. You can filter by the 'Data Entity' column to see which fields are available for each collection.

Using the CSV Export

We encourage you to leverage the CSV Export for your internal business and research needs.  You are also welcome to publish analysis and aggregate statistics derived from the Crunchbase dataset. Unless otherwise noted in your license or Data Access Terms, you may not license, sublicense, sell, offer to sell, distribute or otherwise provide any of the Crunchbase data to any third parties.

Attribution Requirements

When sharing information about the data, follow these attribution requirements.

  • Attribution must be accompanied by a hyperlink to Crunchbase
  • If content being attributed is primarily about one entity, link must point to that entity on Crunchbase.
  • Link must be plainly visible to end user
  • Link must be in close proximity to the attributed data
  • Link must be visible to Internet spiders (e.g. Googlebot)
  • Link cannot include the “nofollow” tag"

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request