> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Migrate data feeds from v1 to v2

> Migrating from Forager data feed v1 to v2: Snowflake-based database, new export destinations, formats and schedules.

![Migrate data feeds from the v1 schema to the v2 schema](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/migrate-data-feeds-v1-to-v2.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=09a7b67886e8bd195c14aa97525db16d)

> [!WARNING]
>
> **Data feed V1 EOL (end of life) support**
>
> Data feed V1 is being retired and will no longer be supported. V1 data feed exports will be completely shut down, so plan your migration to V2 now. Contact [support@forager.ai](mailto:support@forager.ai) for the exact shutdown date.

## Summary

We are migrating our underlying data feed database to Snowflake, this will enable you to have access to following to features:

* Access **crawled data** directly in a Snowflake database shared with your account (updated on a rolling basis)
* Additional export destinations, we now support sending data feeds to the following destinations:
  * Amazon S3
  * Google Cloud Storage
  * Azure Blob (coming soon)
* **Customizable export job schedules**, we can now define any schedule to export your Forager data feed to your destination. Have data sent to your export destination at any frequency (charges do apply).
* Additional file formats, we now can support the following:
  * JSON (NDJSON format)
  * CSV/TSV
  * Parquet
* Compression can now be applied to your data feed export files using any of the following:
  * Gzip (default)
  * bzip2
  * Brotli
  * Zstandard
* Ability to receive net new data only: export only the records updated since the last export.

## Schema

View the full data feed schema [here](https://www.forager.ai/docs/data-license/v2/schema.md).

## File paths and names

View new file path and name formats [here](https://www.forager.ai/docs/data-license/v2/output-data-file-details.md)

## Breaking changes:

1. File export compression, all files are now exported using gzip by default, you do have the option to disable this or select from one of the other supported compression types above.
2. JSON export format, all JSON files will now use NDJSON (one JSON object per line), instead of an array of JSON objects. See an example person file [here](https://www.forager.ai/docs/assets/data_0_0_0.a7202234296aa8827cf5fceb406c6a9652070a7cdf9fc58a11989f741438f15d.4478b203.ndjson), and the row format in [Output Data File Details](https://www.forager.ai/docs/data-license/v2/output-data-file-details.md#row-format).
3. File paths are now restructured to allow schema changes and to easily retrieve updated data only. For example: `/forager_data_feed/<data_feed_id>/<date_created>/<data_feed_type>_<schema_version>/data_<partition_id>.<file_type>.<compression_type>`. See changes [here](https://www.forager.ai/docs/data-license/v2/output-data-file-details.md).
4. Properties no longer supported:
   1. `background_picture`
   2. `is_creator`
   3. `is_influencer`
   4. `temporary_status`
   5. `temporary_emoji_status`
   6. `accessibility_hashtags`
   7. `accessibility_text`
   8. `address`
   9. `primary_locale`
   10. `supported_locales`
5. Renamed or retyped properties (v1 data dictionary column → v2 schema field):
   1. `VOLUNTEERINGS` → [`volunteering`](https://www.forager.ai/docs/data-license/v2/schema/person/person-profile)
   2. `DOMAIN_TRANCO_RANK`: VARCHAR → integer ([`domain_tranco_rank`](https://www.forager.ai/docs/data-license/v2/schema/organization/forager-organization-data))
   3. `KEYWORDS`, `TECHNOLOGIES`: VARCHAR → array of string (`keywords`, `technologies`)
   4. `FUNDING_ROUNDS`: VARCHAR → array of [FundingRound](https://www.forager.ai/docs/data-license/v2/schema/organization/funding-round.md) objects (`funding_rounds`)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.