Try our quick and easy data matching wizard: Create match reports for CSV/TSV datasets on company names, individual names, and addresses in seconds: Start Now!

Batch Data Enrichment API

Enrich entire CSV or TSV files in a single call, appending AI-powered intelligence as new columns on every record

See this API in action with our no-code, browser-based Enrich Wizard

Try the full enrichment engine on your own files without writing any code. Upload a CSV or TSV, pick an enrichment function, map your columns with a few clicks, and see your enriched data in seconds.

Launch the Enrichment Wizard

API Overview

The Batch Data Enrichment API processes an entire file in one request. It reads a CSV or TSV file, calls the enrichment function you choose for every record, and returns each original record with the enrichment results appended as new columns. It is built for high-volume data enrichment across customer, vendor, lead, and account datasets, adding company intelligence, contact and identity data, standardization, translation, and more, without writing per-record enrichment logic.

AI-Powered

Uses AI models, machine learning, and extensive knowledge bases to enrich your records in real time, returning company intelligence, executive and contact data, scoring, classification, and standardized values. Works with international data and different character sets.

Entire-File Processing

Point the API at a CSV or TSV file and it processes every record in the entire file in parallel, streaming back each record with its enrichment columns appended. No need to loop through records or call the API once per row.

Many Enrichment Functions

Choose from a wide set of enrichment functions, from company info, executive profiles, and competitor analysis to email and phone scoring, standardization, translation, and classification, or define your own with the custom function.

How It Works

For each record in your file, the API takes the input value or values you map from your columns, calls the enrichment function you selected, and appends the function's output fields as new columns to that record. The example below shows the business-info function: a company name in column 1 is enriched with company intelligence columns.

Company (input, column 1) CompanyName CompanyLocation Revenue NumberEmployees
IBM International Business Machines Corporation Armonk, New York, USA $61.9B 282,000
Salesforce.com Salesforce, Inc. San Francisco, California, USA $34.9B 72,000

The original columns are preserved and the enrichment function's output fields are added to the right of each record. Different functions append different columns, for example email-trust-score adds a score and reasoning, while tech-stack adds detected platforms and frameworks. Values shown are illustrative.

API Details

Endpoint

https://enrich-api.interzoid.com/enrich

Request Format

https://enrich-api.interzoid.com/enrich?apikey=[apikey]&connection=[file URL]&filetype=[csv|tsv]&function=[enrich function]&[param]_column=[n]

Parameters
Parameter Required Description
apikey Yes Your Interzoid API license key.
connection Yes Public URL (http/https) of the input CSV or TSV file to process.
filetype Yes csv or tsv. Sets both how the input is parsed and the output delimiter.
function Yes Enrichment function to run, for example business-info, translate, email-trust-score, or custom. See the function list below.
[param]_column Conditional 1-based column position to use as an input parameter. The parameter name depends on the function, for example lookup_column for business-info, text_column for translate, org_column for org-standard.
[param]_value Conditional Static value to use for every row instead of a column, for example to_value=Spanish for translate's target language. Use either _column or _value for each input parameter.
has_header No true if the file's first row is a header to skip (not enriched or counted). Its values label the input columns in the output header. Default false.
include_header No true writes a header row as the first output line, listing input column names followed by the enrichment output field names. Default false.
input_headers No JSON array of names for the input columns, used to label them in the output header when the file has no header row of its own.
topic_value Conditional Required when function=custom. Describes the data to retrieve for each row.
output_fields_value Conditional Required when function=custom. JSON array of the output field names to return and append, for example ["Population","Mayor"].
Sample Request

https://enrich-api.interzoid.com/enrich?apikey=fh5hs7*****&connection=https://dl.interzoid.com/csv/companies.csv&filetype=csv&function=business-info&lookup_column=1&has_header=true&include_header=true

Sample Response (CSV, with header)

company,CompanyName,CompanyURL,CompanyLocation,Revenue,NumberEmployees IBM,International Business Machines Corporation,ibm.com,"Armonk, New York, USA",$61.9B,282000 Salesforce.com,"Salesforce, Inc.",salesforce.com,"San Francisco, California, USA",$34.9B,72000

Each input record is returned with the enrichment function's output fields appended as new columns. Values shown are illustrative.

Example Calls

The same endpoint supports many enrichment functions. Below are common patterns, each pointing at a sample file. Replace the file URL, function, and column positions with your own.

1. Company Intelligence (CSV)

Enrich a list of companies with firmographic intelligence (name, URL, location, revenue, employees, and more). The company name or domain is in column 1.

https://enrich-api.interzoid.com/enrich?apikey=fh5hs7*****&connection=https://dl.interzoid.com/csv/companies.csv&filetype=csv&function=business-info&lookup_column=1&has_header=true

2. Translate a Column (CSV)

Translate the text in column 2 to a target language. The text comes from a column, and the target language is a static value applied to every row.

https://enrich-api.interzoid.com/enrich?apikey=fh5hs7*****&connection=https://dl.interzoid.com/csv/phrases.csv&filetype=csv&function=translate&text_column=2&to_value=Spanish&has_header=true

3. Email Trust Score (CSV)

Score the deliverability and trustworthiness of email addresses in column 3, appending a 0 to 99 score and the reasoning to each record.

https://enrich-api.interzoid.com/enrich?apikey=fh5hs7*****&connection=https://dl.interzoid.com/csv/contacts.csv&filetype=csv&function=email-trust-score&lookup_column=3&has_header=true

4. Custom Enrichment (CSV)

Define your own enrichment with the custom function: describe the data you want with topic_value and the columns to append with output_fields_value (a JSON array). The lookup value is in column 1.

https://enrich-api.interzoid.com/enrich?apikey=fh5hs7*****&connection=https://dl.interzoid.com/csv/cities.csv&filetype=csv&function=custom&lookup_column=1&topic_value=City%20statistics&output_fields_value=%5B%22Population%22%2C%22Mayor%22%5D&has_header=true

5. cURL Example (API key in header)

The API key can be passed in the x-api-key header instead of the query string. The enriched output streams to your terminal or a file.

curl --header "x-api-key: fh5hs7*****" "https://enrich-api.interzoid.com/enrich?connection=https://dl.interzoid.com/csv/companies.csv&filetype=csv&function=business-info&lookup_column=1&has_header=true" -o enriched.csv

Available Enrichment Functions

Choose a function with the function parameter. Each appends its own set of output columns to every record. Many enrichment functions are also available as single-record APIs with their own documentation and tools.

Company Intelligence

Firmographics and corporate intelligence: business-info, parent-company, executive-profile, competitor-analysis, buying-signals, private-company-deal-intel, company-verification, industry-classification, and stock-analysis.

Contact & Identity

Score and profile contact data: email-trust-score, phone-profile, ip-profile, and x-handle for finding the X (Twitter) handle of a person or organization.

Standardization & Parsing

Normalize inconsistent values: org-standard, city-standard, state-standard, country-standard, address-parse, entity-type, name-origin, and gender-from-name.

Translation, Tech & More

Enrich with translate (any language), tech-stack (website technology detection), university-info, and custom for your own AI-defined fields. See the full list via the /functions endpoint.

Try the Request Builder

Build a Batch Enrichment Request

Fill in your file URL, enrichment function, and input column to generate a ready-to-call request URL. The batch API streams a file of results, so this tool builds the URL for you to call with curl or the Enrich Wizard rather than running it inline.

Algorithm & AI Model Information

Enrichment Models

Each enrichment function is powered by AI models, machine learning, specialized algorithms, and extensive knowledge bases tuned to its data domain, from company intelligence and contact scoring to standardization, parsing, and translation. The custom function uses a premium model to retrieve and structure data fields you define at request time. Output fields and their meaning vary by function.

Code Examples, Database Queries, and Specifications

Usage Examples

See quick and easy code examples in multiple programming languages, including Python, Node.js, Java, Typescript, and Go. Also see how to use the enrichment APIs within database queries on popular database platforms and open specifications such as OpenAPI.

See All Examples

Additional Resources

Use this API with the No-Code Enrich Wizard

Our Enrich Wizard no-code batch tool runs this enrichment engine within our parallel-processing Cloud platform. Upload or connect a CSV/TSV file, pick a function, map your columns with a few clicks, and enrich your data in seconds, without writing any code. It is the fastest way to use this API with higher volumes of data.

Start Now
List All Functions Programmatically

The /functions endpoint returns a JSON array of every enrichment function with its input parameters and output fields, for discovery and documentation. Call it to see the full, current set of functions and the columns each one appends.

https://enrich-api.interzoid.com/functions

Alternative Access: Pay Per Use with x402 (No API Key)

Most users access this API with a standard Interzoid API key, as shown throughout this page. As an alternative, the same endpoint also supports x402 pay-per-use payments, where you pay per record in USDC on the Base network instead of using a key or subscription. Pricing varies by function. This is aimed at AI agents and automated systems that need on-demand access without managing credentials. If you are using an API key, no action is needed.

Learn About x402 Access
Service Bureau - Our Data Enrichment Task Force

Want us to do it for you? We can take your data and run our enrichment products on your behalf with a quick turnaround:

Contact Support

Sample Enrichment Output

A few examples of what different functions append to each record. Values shown are illustrative.

Function Input Appended Columns (sample)
business-info Tesla Tesla, Inc. | Austin, Texas, USA | $96.8B | 140,473
email-trust-score info@example.com Score: 42 | Reasoning: role-based address on a low-traffic domain
tech-stack shopify.com Ruby on Rails | React | Cloudflare CDN | Shopify
org-standard intl bus mach International Business Machines
translate (to Spanish) Good morning Buenos días