Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Peopledatalabs API

Give your agents access to Peopledatalabs API. Bring your own Peopledatalabs key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Peopledatalabs

Instant

Peopledatalabs delivers B2B data enrichment and identity resolution APIs. Supercharge your apps with accurate, up-to-date business and contact data.

26 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Peopledatalabs without a separate account or API key for each one. New accounts start with $2 of free credit.

No Peopledatalabs account or key

Your agent calls Peopledatalabs through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.1 per company matched, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Peopledatalabs with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Peopledatalabs API to your AI assistant

Use Peopledatalabs from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use People Data Labs through Composio Instant to enrich the company at microsoft.com. Return its firmographics and employee count.

What success looks like

PEOPLEDATALABS_ENRICH_COMPANY_DATA

Your assistant runs People Data Labs and replies with Microsoft’s company details, including its firmographics and employee count.

Runs on Composio Instant

SDK

Use the Peopledatalabs API in your code

Call Peopledatalabs from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
PEOPLEDATALABS_ENRICH_COMPANY_DATA
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["peopledatalabs"],
    instant={
        "toolkits": {"enable": ["peopledatalabs"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "PEOPLEDATALABS_ENRICH_COMPANY_DATA",
    arguments={
        "website": "microsoft.com",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["peopledatalabs"],
  instant: {
    toolkits: { enable: ["peopledatalabs"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "PEOPLEDATALABS_ENRICH_COMPANY_DATA",
  {
    "website": "microsoft.com"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": "<company profile>",
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Peopledatalabs API tools

20 Peopledatalabs tools run on Instant, priced per call with no Peopledatalabs key. Tools marked Your key need your own Peopledatalabs account.

Action	Tool slug	What it does	Availability
Enrich Company	PEOPLEDATALABS_ENRICH_COMPANY_DATA	Add firmographics and employee counts using a company identifier.	Instant$0.1 per company matched35% off
Enrich Person	PEOPLEDATALABS_ENRICH_PERSON_DATA	Add profile data using a person identifier or matching details.	Instant$0.28 per person matched10% off
Search Companies	PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC	Find company profiles that match an Elasticsearch query.	Instant$0.1 per company returned35% off
Search People	PEOPLEDATALABS_PEOPLE_SEARCH_ELASTIC	Find person profiles by job title, skills, company, or location.	Instant$0.28 per person returned10% off
Identify Person	PEOPLEDATALABS_IDENTIFY_PERSON_DATA	Find a person profile using attributes such as name, company, or location.	Instant$0.55 per Person Identify request9% off
Autocomplete field suggestions	PEOPLEDATALABS_GET_AUTOCOMPLETE_SUGGESTIONS	Provides autocompletion suggestions for a specific field (e.g., company, skill, title) based on partial text input.	Instant$0 per request
Clean company data	PEOPLEDATALABS_CLEAN_COMPANY_DATA	Cleans and standardizes company information based on a name, website, or profile URL; providing at least one of these inputs is highly recommended for meaningful results.	Instant$0 per request
Clean company data (POST)	PEOPLEDATALABS_CLEAN_COMPANY_POST	Tool to clean and standardize company data using POST method.	Instant$0 per request
Clean location data	PEOPLEDATALABS_CLEAN_LOCATION_DATA	Cleans and standardizes a raw, unformatted location string into a structured representation, provided the input is a recognizable geographical place.	Instant$0 per request
Clean location data (POST)	PEOPLEDATALABS_CLEAN_LOCATION_POST	Tool to clean and standardize location data using POST method.	Instant$0 per request
Clean school data	PEOPLEDATALABS_CLEAN_SCHOOL_DATA	Cleans and standardizes school information; provide at least one of the school's name, website, or profile for optimal results.	Instant$0 per request
Clean school data (POST)	PEOPLEDATALABS_CLEAN_SCHOOL_DATA_POST	Tool to clean and standardize school data using POST method.	Instant$0 per request
Enrich Bulk Company Data	PEOPLEDATALABS_ENRICH_BULK_COMPANY_DATA	Tool to enrich up to 100 companies in a single request using the Bulk Company Enrichment API.	Instant$0.1 per company matched in the batch35% off
Enrich bulk person data	PEOPLEDATALABS_ENRICH_BULK_PERSON_DATA	Enrich up to 100 person profiles in one Bulk Person Enrichment request using supported identifiers and matching parameters.	Instant$0.28 per person matched in the batch10% off
Enrich IP Data	PEOPLEDATALABS_ENRICH_IP_DATA	Enrich an IP address with People Data Labs company data and, where available and requested, IP location, metadata, and person data.	Instant$0.072 per IP address matched33% off
Get autocomplete suggestions (POST)	PEOPLEDATALABS_GET_AUTOCOMPLETE_SUGGESTIONS_POST	Tool to get autocompletion suggestions using POST method for complex query parameters.	Instant$0 per request
Get column details	PEOPLEDATALABS_GET_COLUMN_DETAILS	Look up predefined enum values and their descriptions for a specified column.	Instant$0 per request
Get schema	PEOPLEDATALABS_GET_SCHEMA	Retrieves the schema, including field names, descriptions, and data types, for 'person' or 'company' entity types.	Instant$0 per request
Query person changelog	PEOPLEDATALABS_QUERY_PERSON_CHANGELOG	Query the person changelog between dataset versions for updates, additions, deletions, merges, and opt-outs.	Instant$0 per request
Search Company Records (POST)	PEOPLEDATALABS_SEARCH_COMPANY_POST	Tool to search and filter company records from the full Company Dataset using Elasticsearch or SQL queries via POST method.	Instant$0.1 per company returned35% off
Retrieve Person	PEOPLEDATALABS_RETRIEVE_PERSON	Retrieve a person record by persistent People Data Labs ID.	Your key
Search Job Postings	PEOPLEDATALABS_SEARCH_JOB_POSTINGS	Find job postings using filters and cursor pagination.	Your key

Instant prices are Peopledatalabs's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Peopledatalabs API use cases and example prompts

Copy a prompt into your agent. Each one uses Peopledatalabs with apps you connect through Composio.

Enrich target accounts
Use People Data Labs to add firmographics and employee counts to the company records in my target accounts list in HubSpot. Update those HubSpot records and add the results to my Account Tracker in Google Sheets.
Apps used: Peopledatalabs, HubSpot, Google Sheets
Map companies in a market
Use People Data Labs to find company profiles for businesses in the healthcare software market in the United States. Add the results to my Market Map in Google Sheets, then post a summary in Slack's #market-research channel.
Apps used: Peopledatalabs, Google Sheets, Slack
Summarize a talent pool
Use People Data Labs to find profiles for product designers with UX research skills in the United States. Summarize the skills and locations represented in the results without including names or contact details, and save the findings as a page in my Hiring Research space in Notion.
Apps used: Peopledatalabs, Notion
Enrich Acme contact records
Use People Data Labs to add profile data to the existing Acme contact records in HubSpot, using the supported identifiers already on each record. Update the records with the results and prepare a Gmail draft for the account owner to review.
Apps used: Peopledatalabs, HubSpot, Gmail

TROUBLESHOOTING

Peopledatalabs API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Lower min_likelihood in PEOPLEDATALABS_ENRICH_PERSON_DATA; higher values require a stricter match.

Pass the returned scroll_token to PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC to continue through the results.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Peopledatalabs account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

Start with Peopledatalabs.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Peopledatalabs tool your agent needs.Free to start.

Start building

Peopledatalabs API

What is Composio Instant?

No Peopledatalabs account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Peopledatalabs API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Peopledatalabs API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Peopledatalabs API tools

Peopledatalabs API use cases and example prompts

Enrich target accounts

Map companies in a market

Summarize a talent pool

Enrich Acme contact records

Peopledatalabs API troubleshooting

Person enrichment misses a likely match

Company search returns only the first page

An action asks you to connect Peopledatalabs

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Firecrawl

Tavily

Exa

Serpapi

Start with Peopledatalabs.It takes 30 seconds.