REST API

The enrichment API built for AI agents.

One endpoint. Self-describing schema. Built-in research tools. Your AI reads the spec, queries contacts, searches the internet, enriches data, and writes results back — all through a single URL.

Start Free

No credit card · No SDK · Any language, any AI

Most enrichment APIs give you data. This one gives your AI data + research + database in one endpoint.

Self-Describing

One URL. Full autonomy.

Your AI makes a single GET request and understands everything: columns, types, available actions, filter conditions, permissions, and rate limits. No documentation to read. No SDK to install.

Schema Discovery

GET the endpoint → receive column names, data types, content types, allowed actions, and permission boundaries. The AI knows what it can do before it does anything.

Zero Configuration

No API keys to configure on the client. No authentication headers to manage. The token is the URL. Paste it into any AI and it works.

Machine-Readable Spec

The response is a structured JSON schema — not a human-readable docs page. Optimized for LLMs and automation frameworks like LangChain, CrewAI, or n8n.

terminal — schema discovery
# One GET request. The AI knows everything.
curl https://listplus.ai/d/your_token
{
"name": "Pipeline Q2",
"columns": [
{"name":"email","type":"email","writable":true},
{"name":"company","type":"company","writable":true},
{"name":"job_title","type":"jobTitle","writable":true}
],
"actions": ["query","add_records","update",
"enrich","google_search","website_scrape",...],
"filters": 42,
"rate_limit": "60/min",
"row_cap": 5000
}
Built-in Research

6 research tools inside the API.

No external integrations. No third-party API keys. Your AI searches the internet, scrapes websites, and looks up companies — all through the same endpoint.

google_search0.1 cr

Web, News, Jobs, Scholar with geo-targeting. ~€0.003 per query.

website_scrapeFREE

Any public URL to structured Markdown. Team pages, job postings, pricing pages.

hackernews_searchFREE

Stories, comments, usernames. Find founders, hiring signals, tech discussions.

reddit_search0.5 cr

Posts, comments, subreddit-specific search. Intent signals and competitor frustration.

twitter_search0.5 cr

Tweets and profiles by keyword. Track discussions and identify influencers.

company_lookup0.25 cr

Domain to company profile: industry, size, revenue, tech stack. Often free from cache.

All tools are called through the same endpoint. Your AI chains them: search → scrape → enrich → write. No orchestration layer needed.

Code Examples

curl and you’re done.

Three requests is all it takes. Discover the schema, run a research query, write results back.

1. Discover the schema
terminal
# Returns columns, types, actions, permissions
curl https://listplus.ai/d/your_token
2. Search Google for leads
terminal
# 0.1 credits per query
curl -X POST https://listplus.ai/d/your_token \
-H "Content-Type: application/json" \
-d '{"action":"google_search","query":"CTO site:linkedin.com DACH SaaS"}'
→ {"results":[{"title":"Jane Smith - CTO at Acme","url":"linkedin.com/in/..."},...], "count":10}
3. Write enriched data back (only_empty mode)
terminal
# Never overwrites existing values
curl -X POST https://listplus.ai/d/your_token \
-H "Content-Type: application/json" \
-d '{"action":"update",
"filter":{"email":{"condition":"is_not_empty"}},
"set":{"company":"Acme Corp","job_title":"CTO"},
"only_empty":true}'
→ {"updated":47,"skipped":153,"mode":"only_empty"}
Smart Filters

42 conditions. Not just “contains”.

The API understands job roles, email types, data quality issues, and fuzzy matching. Your AI queries with semantic conditions — not regex.

Role Detection

8 conditions
c_level_executivedecision_makertechnical_rolesales_role

Email Intelligence

7 conditions
corporate_emaildisposable_emailemail_typorole_based_email

Fuzzy Matching

4 conditions
fuzzy_matchsounds_likenear_duplicate

Data Quality

6 conditions
needs_name_standardizationphone_needs_cleaningis_placeholder

Completeness

5 conditions
is_emptyis_not_emptyhas_enrichment_data

Comparison

12 conditions
equalscontainsstarts_withgreater_thanin

Your AI translates natural language into filter queries automatically. "Find decision makers with corporate email in Germany" → three conditions, one API call.

Security

Granular controls on every endpoint.

Column Visibility

Hide sensitive fields from the AI entirely.

Write Whitelist

Define exactly which columns are writable.

Fill-Only-Empty

AI fills blank fields only — never overwrites.

Rate Limits

Requests per minute, auto-throttled.

Row Caps

Maximum rows readable or modifiable per request.

Auto-Expiration

Endpoint disables itself after a set date.

Audit Logs

Every call logged with IP, timestamp, and diff.

Bearer Auth

Optional token. Rotate anytime.

Cost Transparency

You know what you pay. Always.

The API is included in all plans. Research tools have fixed, predictable costs. No hidden fees, no per-seat multipliers.

google_search0.1 cr (~€0.003)
website_scrapeFREE
hackernews_searchFREE
reddit_search0.5 cr (~€0.015)
twitter_search0.5 cr (~€0.015)
company_lookup0.25 cr (~€0.008)
Contact enrichment2–4 cr (~€0.06–0.12)

1,000 contacts researched and enriched overnight: ~€4 total. Web scraping and Hacker News search are free — no limits.

FAQ

Common questions about the API.

What makes this different from other enrichment APIs?
Most enrichment APIs are databases you query: send an email, get a profile back. This API combines a contact database, research tools (Google, Reddit, HN, Twitter, web scraping), smart filters (42 conditions), quality scoring (90+ checks), and full read+write access — all through one self-describing endpoint. Your AI doesn’t just look up data. It researches, validates, enriches, and writes back autonomously.
Do I need an SDK?
No. The API is standard REST. Any language that makes HTTP requests works: curl, Python requests, JavaScript fetch, Go net/http, Rust reqwest. The endpoint is self-describing — your AI reads the schema via GET, then operates via POST and PATCH. Zero dependencies.
What AI models work with the API?
Any model that makes HTTP requests: Claude, GPT-4, GPT-4o, Gemini, Mistral, Llama, Qwen, and self-hosted models. Plus MCP-native support for Claude Desktop and Claude Code. Automation platforms like n8n, Make, and Zapier work too.
How much does enrichment cost per record?
Company enrichment: 0.25 credits (~€0.008). Contact enrichment: 2–4 credits (~€0.06–0.12) depending on the provider. Google search: 0.1 credits (~€0.003). Web scraping and HN search are free. A full overnight run — 1,000 contacts researched and enriched — costs roughly €4.
Can I use the research tools without an AI agent?
Yes. The research tools are standard API actions. You can call google_search, website_scrape, or hackernews_search directly via curl or any HTTP client. No AI required — the tools work the same way whether called by a human or an agent.

AI Agent API — Full Details →Integrations→Pricing→

One endpoint.
Full autonomy.

Schema discovery. Research tools. Smart filters. Enrichment. Write-back. — All in one URL.

Start Free