Zintlr API
## What is Zintlr? Zintlr is a B2B data intelligence and sales enablement platform designed to empower sales teams, marketers, and developers with the tools they need to find, engage, and convert prospects efficiently. By leveraging a comprehensive database of 400M+ business contacts and 70M+ companies, Zintlr provides unparalleled access to detailed professional information and advanced lookup capabilities. Zintlr is GDPR compliant, SOC 2 certified, and ISO certified — trusted by high-growth companies including ICICI Bank, Bajaj Capital, HubSpot, Cashfree, and more. ## Introduction to Zintlr's APIs The Zintlr Platform API enables seamless integration with Zintlr's enrichment, prospecting, and intelligence capabilities, allowing you to embed them directly into your own products Use cases for Zintlr's APIs include, but are not limited to: - **Build integrations:** Integrate Zintlr's data and features in your own integrations. Use the API to query the endpoints you need to retrieve data, enrich contacts, and automate workflows. - **Enrich data:** Use the Analytics endpoints to perform data enrichment for both people and organizations. Enrich the data of an individual person or organization, or enrich data in bulk. - **Find people:** Use the Lookup endpoints to search Zintlr's data and find exact prospects based on email, phone, LinkedIn URL, or DIN. - **Analyze personality:** Use the Personality endpoints to generate AI-powered personality assessments and sales engagement recommendations from LinkedIn profiles. - **Access Indian data:** Use the Indian Data Suite endpoints to retrieve government-issued identifiers and deep demographic intelligence for prospects in India.
Email to Phone — POST /b2b2b/v1/email-to-phone/
## Overview The **Email to Phone** API enables reverse-lookup from email addresses to associated phone numbers. Pass a batch of prospect email addresses and receive all matching direct-dial phone numbers for each — making it easy to enrich your contact records and connect with leads faster. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/email-to-phone/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | -------------- | ---------------------------------------- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`emails`** (`array[string]`) — **Required** List of prospect email addresses to look up phone numbers for. #### Example Request Body ```json { "emails": [ "[email protected]", "[email protected]" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "emails": [ "[email protected]", "[email protected]" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/email-to-phone/" ``` --- ## Request & Response
Phone to Email — POST /b2b2b/v1/phone-to-email/
## Overview The **Phone to Email** API enables reverse-lookup from phone numbers to associated email addresses. Pass a batch of prospect phone numbers and receive all matching email addresses for each — making it easy to enrich your contact records and reach leads through their preferred inbox. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/phone-to-email/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`phone_numbers`** (`array[string]`) — **Required** List of prospect phone numbers (in international format) to look up associated email addresses for. #### Example Request Body ```json { "phone_numbers": [ "+91 9876543210" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "phone_numbers": [ "+91 9876543210" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/phone-to-email/" ``` --- ## Request & Response
LinkedIn URL to Profile Data — POST /b2b2b/v1/ln-url-to-ln-data/
## Overview The LinkedIn URL to Profile Data API enables enriched reverse-lookup from LinkedIn URLs to comprehensive profiles. Pass a batch of LinkedIn URLs and receive structured data for each — job titles, company details, education, skills, verified emails, phone numbers, and more. Set `company_fetch` to control what the URLs mean: - `false` — the URLs are **person** profiles (`linkedin.com/in/...`) and person profiles are returned. - `true` — the URLs are **company** profiles (`linkedin.com/company/...`) and company profiles are returned. The response `data` is keyed by the input URL, so results map back to exactly what you sent. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/ln-url-to-ln-data/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: - **`Access-Token`**: Your account access token (test or live) - **`Secret-Key`**: Your account secret key > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`ln_urls`** (`array[string]`) — **Required** List of LinkedIn URLs to fetch data for (**upto 50**). When `company_fetch` is `false` these must be person profile URLs (`linkedin.com/in/...`); when `company_fetch` is `true` they must be company URLs (`linkedin.com/company/...`). - **`company_fetch`** (`boolean`) — **Required** When `true`, the `ln_urls` are treated as company URLs and company profiles are returned; when `false`, they are treated as person profile URLs and person profiles are returned. #### Example Request Body ```json { "ln_urls": [ "https://www.linkedin.com/in/john-doe", "https://www.linkedin.com/in/jane-doe" ], "company_fetch": false } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "ln_urls": [ "https://www.linkedin.com/in/john-doe", "https://www.linkedin.com/in/jane-doe" ], "company_fetch": false }' "https://b2b2b.zintlr.com/b2b2b/v1/ln-url-to-ln-data/" ``` --- ## Request & Response
LinkedIn URL to Phone & Email — POST /b2b2b/v1/ln-url-to-ph-email/
## Overview The LinkedIn URL to Phone & Email API enables targeted contact enrichment from a LinkedIn profile URL. Pass a single LinkedIn profile URL along with boolean flags to selectively unlock phone numbers, email addresses, or both — giving you precise control over what data is retrieved and ensuring credit-efficient lookups when only one contact type is needed. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/ln-url-to-ph-email/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: - **`Access-Token`**: Your account access token (test or live) - **`Secret-Key`**: Your account secret key > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`ln_url`** (`string`) — **Required** LinkedIn profile URL of the prospect to look up contact details for. - **`phone_unlock`** (`boolean`) — Optional Set to true to unlock and return phone numbers associated with the LinkedIn profile. Defaults to false if omitted. - **`email_unlock`** (`boolean`) — Optional Set to true to unlock and return email addresses associated with the LinkedIn profile. Defaults to false if omitted. #### Example Request Body ```json { "ln_url": "linkedin.com/in/john-doe", "phone_unlock": true, "email_unlock": true } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "ln_url": "linkedin.com/in/john-doe", "phone_unlock": true, "email_unlock": true }' "https://b2b2b.zintlr.com/b2b2b/v1/ln-url-to-ph-email/" ``` --- ## Request & Response
People Search — POST /b2b2b/v1/people/search/
## Overview The **People Search** API enables structured filtering to find B2B people prospects across Zintlr's database. Combine company-level filters (industry, workforce size, location, year founded) with people-level filters (job title, department, seniority, location) to retrieve a paginated list of matching person profiles — each enriched with their current company details. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/people/search/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`company_filters`** (`object`) — Optional Company-level filters narrowing the search by the prospect's current company. All sub-fields are optional; only provided fields are applied. - **`people_filters`** (`object`) — Optional People-level filters narrowing the search by the prospect's personal and professional attributes. All sub-fields are optional; only provided fields are applied. - **`page`** (`integer`) — Optional 1-indexed page number for paginating through the result set. - **`count`** (`integer`) — Optional Number of profiles to return per page. Range: 1–20. Defaults to 10. #### Example Request Body ```json { "company_filters": { "industry": ["Information Technology", "SaaS"], "workforce_size": { "min": 50, "max": 500 }, "company_hq_location": { "country": ["India"] } }, "people_filters": { "department": ["Sales", "Marketing"], "seniority": ["VP", "Director"] }, "page": 1, "count": 10 } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "company_filters": { "industry": ["Information Technology", "SaaS"], "workforce_size": { "min": 50, "max": 500 } }, "people_filters": { "department": ["Sales", "Marketing"], "seniority": ["VP", "Director"] }, "page": 1, "count": 10 }' "https://b2b2b.zintlr.com/b2b2b/v1/people/search/" ``` --- ## Request & Response
People AI Search — POST /b2b2b/v1/people/ai-search/
## Overview The **People AI Search** API enables natural-language search across Zintlr's B2B people database. Pass a free-form query like *"VPs of Sales at SaaS companies in India with 100–500 employees"* and Zintlr's AI parses the intent, translates it into structured filters, and returns a paginated list of matching person profiles — each enriched with their current company details. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/people/ai-search/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`query`** (`string`) — **Required** Free-form natural-language description of the people you want to find. Maximum 500 characters. - **`page`** (`integer`) — Optional 1-indexed page number for paginating through the result set. - **`count`** (`integer`) — Optional Number of profiles to return per page. Range: 1–20. Defaults to 10. #### Example Request Body ```json { "query": "Heads of Marketing at fintech companies in Bengaluru with 50-200 employees", "page": 1, "count": 10 } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "query": "Heads of Marketing at fintech companies in Bengaluru with 50-200 employees", "page": 1, "count": 10 }' "https://b2b2b.zintlr.com/b2b2b/v1/people/ai-search/" ``` --- ## Request & Response
Domain to CIN — POST /b2b2b/v1/domain-to-cin/
## Overview The **Domain to CIN** API enables reverse-lookup from company web domains to their Corporate Identification Numbers (CINs). Pass a batch of company domains and receive a resolution result — `found` holds one record per resolved domain (CIN, company name, status, type, year of incorporation, and website), `not_found` lists domains that could not be resolved, and `summary` gives input/found/not-found counts. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/domain-to-cin/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`domain_list`** (`array[string]`) — **Required** List of company web domains to resolve to Corporate Identification Numbers (CINs). #### Example Request Body ```json { "domain_list": [ "example.com" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "domain_list": [ "example.com" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/domain-to-cin/" ``` --- ## Request & Response
CIN to Company Data — POST /b2b2b/v1/cin-to-company-data/
## Overview The **CIN to Company Data** API enables enriched lookup from Corporate Identification Numbers (CINs) to full company records. Pass a batch of CINs (up to 50) and receive detailed company data for each — including registered address, revenue, paid-up capital, industry classification, and company LinkedIn URL. Set `include_director_details` to true to also receive director-level person records (`person_data`) and per-director data nested within each company (`directors_data`). > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/cin-to-company-data/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`cin_list`** (`array[string]`) — **Required** List of Corporate Identification Numbers (CINs) to fetch company data for. Maximum 50 CINs per request. - **`include_director_details`** (`boolean`) — **Required** When true, the response includes director-level person records (person_data) and per-director data (directors_data) alongside company data. #### Example Request Body ```json { "cin_list": [ "U00000AA0000AAA000001" ], "include_director_details": true } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "cin_list": [ "U00000AA0000AAA000001" ], "include_director_details": true }' "https://b2b2b.zintlr.com/b2b2b/v1/cin-to-company-data/" ``` --- ## Request & Response
Domain to LinkedIn URL — POST /b2b2b/v1/domain-to-ln-url/
## Overview The **Domain to LinkedIn URL** API enables reverse-lookup from company web domains to their company LinkedIn profiles. Pass a batch of company domains and receive a map keyed by each input domain — a resolved domain maps to a company profile object (LinkedIn URL, name, industry, size, location, headcount, description, specialities, and more), while an unresolved domain maps to the string `"not_found"`. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/domain-to-ln-url/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`domains`** (`array[string]`) — **Required** List of company web domains to resolve to company LinkedIn profiles. #### Example Request Body ```json { "domains": [ "example.com" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "domains": [ "example.com" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/domain-to-ln-url/" ``` --- ## Request & Response
Contact to LinkedIn URL — POST /b2b2b/v1/contact-to-ln-url/
## Overview The **Contact to LinkedIn URL** API enables lookup from a prospect's contact details to their LinkedIn profile. Pass a list of email addresses, phone numbers, or both, and receive the best-matched person profile — including LinkedIn URL, name, job title, location, which inputs matched (`matched_on`), a `confidence` label, and a numeric `score`. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/contact-to-ln-url/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`email`** (`array[string]`) — Optional List of prospect emails. At least one of email or phone is required. Maximum 50 per request. - **`phone`** (`array[string]`) — Optional List of prospect phone numbers. At least one of email or phone is required. Maximum 50 per request. > **Note:** At least one of `email` or `phone` must be provided in the request. #### Example Request Body ```json { "email": [ "[email protected]" ], "phone": [ "919999999999" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "email": [ "[email protected]" ], "phone": [ "919999999999" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/contact-to-ln-url/" ``` --- ## Request & Response
Reverse Enrichment — POST /b2b2b/v1/reverse-enrichment/
## Overview The **Reverse Enrichment** API enables LinkedIn profile discovery from basic prospect details. Pass a list of persons — each with a name, company, and optionally a job title — and receive a run-level summary plus a per-person `results` list. Each result echoes the input and includes `company_resolution`, a detailed `person_match` (with score breakdown and profile snapshot), and the resolved `ln_url`. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/reverse-enrichment/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: | Header | Description | | --- | --- | | `Access-Token` | Your account access token (test or live) | | `Secret-Key` | Your account secret key | > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`persons`** (`array[object]`) — **Required** List of persons to resolve. Each item requires `person_name` and `company_name`, plus at least one of `company_domain` or `company_linkedin_url`; `job_title` is optional. #### Example Request Body ```json { "persons": [ { "person_name": "John Doe", "company_name": "Example", "job_title": "Founder", "company_domain": "example.com" } ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "persons": [ { "person_name": "John Doe", "company_name": "Example", "job_title": "Founder", "company_domain": "example.com" } ] }' "https://b2b2b.zintlr.com/b2b2b/v1/reverse-enrichment/" ``` --- ## Request & Response
DIN to Phone — POST /b2b2b/v1/din-to-phone/
## Overview The DIN to Phone API enables reverse-lookup from a valid Director Identification Numbers (DIN) to associated phone numbers. Pass a batch of DINs and receive all matching direct-dial phone numbers for each — making it easy to identify and connect with company directors registered in India's Ministry of Corporate Affairs (MCA) database. > **Base URL:** `https://b2b2b.zintlr.com` --- ## Endpoint ``` POST /b2b2b/v1/din-to-phone/ ``` --- ## Authentication This endpoint requires **two** headers for authentication: - **`Access-Token`**: Your account access token (test or live) - **`Secret-Key`**: Your account secret key > **Sandbox / Test Mode:** Use the test token to safely explore the API without consuming live credits. --- ## Request #### Headers ```http Content-Type: application/json Access-Token: <your-access-token> Secret-Key: <your-secret-key> ``` #### Body Parameters - **`dins`** (`array[string]`) — **Required** List of Director Identification Numbers (DIN) to look up associated phone numbers for. #### Example Request Body ```json { "dins": [ "00000001", "00000002" ] } ``` --- #### cURL ```bash curl -X POST -H "Access-Token: <your-access-token>" -H "Secret-Key: <your-secret-key>" -H "Content-Type: application/json" -d '{ "dins": [ "00000001", "00000002" ] }' "https://b2b2b.zintlr.com/b2b2b/v1/din-to-phone/" ``` --- ## Request & Response
