API reference
Marketing data for your agents: AI visibility, keywords, SEO, ads, buying intent and reviews. Every endpoint is a JSON POST to https://api.enrichlabs.ai/v1, and every endpoint is also an MCP tool. Machine-readable spec: openapi.json.
curl https://api.enrichlabs.ai/v1/aco/muse \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"question": "Find me a vegan protein powder that mixes well in water",
"business": {
"name": "Acme Nutrition",
"domain": "acmenutrition.com"
},
"followup": "Why not Acme Nutrition?"
}'Authentication
Create a key in the console and send it as a bearer token (x-api-key works too). Keys are shown once. Revoke a leaked key in the console and requests using it fail immediately. Each key is limited to 60 requests per minute.
Authorization: Bearer elk_...
Credits
Calls draw from your account's prepaid credits. New accounts start with 250 free credits; buy packs of 1,000 ($19), 5,000 ($89) or 15,000 ($169) in the console. Failed calls are refunded, and the X-Credits-Charged response header shows what a call cost.
| Endpoint | Cost |
|---|---|
| POST /geo/visibility | 1 per answer (prompts x platforms) |
| POST /aco/muse | 5 per answer (10 with a follow-up) |
| POST /geo/mentions | 15 per query |
| POST /keywords | 5 per call |
| POST /serp | 1 per call |
| POST /ads/search | 5 per call |
| POST /ads/library | 10 per competitor |
| POST /intent/signals | 20 per call |
| POST /intent/opportunities | 20 per platform (40 for both) |
| POST /reviews | 5 per call |
Errors
Every error has the same shape:
{
"error": {
"type": "insufficient_credits",
"message": "This call costs 5 credits. Buy more at https://platform.enrichlabs.ai."
}
}| Status | Type | Meaning |
|---|---|---|
| 400 | invalid_request_error | The body failed validation. |
| 401 | authentication_error | Missing, unknown or revoked key. |
| 402 | insufficient_credits | Balance is below the call cost. |
| 403 | permission_error | The API is not enabled for this account. |
| 404 | not_found_error | Unknown route, job or business. |
| 429 | rate_limit_error | Over 60 requests per minute for this key. |
| 502 | provider_error | An upstream data provider failed. |
MCP
Every endpoint is also a tool on the MCP server at https://api.enrichlabs.ai/v1/mcp (Streamable HTTP, same API key). Tool names are the endpoint names with underscores, such as geo_visibility, plus get_job.
claude mcp add --transport http enrich \ https://api.enrichlabs.ai/v1/mcp \ --header "Authorization: Bearer $ENRICH_API_KEY"
{
"mcpServers": {
"enrich": {
"type": "http",
"url": "https://api.enrichlabs.ai/v1/mcp",
"headers": {
"Authorization": "Bearer ${ENRICH_API_KEY}"
}
}
}
}Jobs
Slow endpoints return 202 with a job. Poll every 10 to 30 seconds until status is succeeded (with result) or failed (with error; credits are refunded). Results are kept for 15 minutes after the job finishes, and polling is free.
{
"id": "mcpjob_CdyhFBqgRvxEI_L4K5vw",
"object": "job",
"status": "succeeded",
"result": {
"brand": "Acme",
"site_url": "https://acme.io",
"platforms": [
{
"platform": "chatgpt-web",
"answers": 2,
"mention_rate": 0.5,
"citation_rate": 0,
"share_of_voice": {
"Acme": 0.5,
"Rivalco": 1
},
"results": [
{
"query": "best ai marketing agent",
"mentioned": false,
"cited": false,
"position": null,
"competitors_mentioned": [
"Rivalco"
],
"cited_urls": [
"https://rivalco.com/blog/..."
]
}
]
}
]
}
}AI visibility audit
Gets live ChatGPT and Gemini results for each query and reports how often your brand and competitors are mentioned and cited. Returns a job; poll GET /jobs/{id}. Typically takes 2 to 6 minutes.
Body
| Field | Type | Notes |
|---|---|---|
brand_namerequired | string | |
site_urlrequired | string | |
queriesrequired | string[] | Prompts a buyer would ask an AI assistant. 1 to 20 items |
competitors | string[] | Competitor brand names to track. 0 to 5 items |
platforms | ("chatgpt-web" | "gemini-web")[] | Defaults to both. At least 1 item |
curl https://api.enrichlabs.ai/v1/geo/visibility \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"brand_name": "Acme",
"site_url": "https://acme.io",
"competitors": [
"Rivalco",
"OtherAI"
],
"queries": [
"best ai marketing agent",
"acme vs rivalco"
],
"platforms": [
"chatgpt-web",
"gemini-web"
]
}'{
"id": "mcpjob_CdyhFBqgRvxEI_L4K5vw",
"object": "job",
"status": "running"
}Ask Muse
Asks Meta's Muse shopping agent a shopper's question in a real Muse chat and returns its full reply, plus whether it recommended your business (business.status, recommended, brands). Returns a job; poll GET /jobs/{id}. Usually takes 3 to 10 minutes, longer when demand is high.
Body
| Field | Type | Notes |
|---|---|---|
questionrequired | string | What a shopper would ask Muse. |
business | object | Business to check the reply for: recommended, mentioned or absent. |
followup | string | Asked in the same chat after the reply. |
curl https://api.enrichlabs.ai/v1/aco/muse \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"question": "Find me a vegan protein powder that mixes well in water",
"business": {
"name": "Acme Nutrition",
"domain": "acmenutrition.com"
},
"followup": "Why not Acme Nutrition?"
}'{
"id": "musejob_3f9c1a7e5b2d4c6f8a0e1b3d",
"object": "job",
"status": "running"
}AI mentions index
Mention counts, AI search volume and top cited source domains for each brand or domain, from an index of Google AI Overviews and ChatGPT answers. Fast, no browser.
Body
| Field | Type | Notes |
|---|---|---|
queriesrequired | string | string[] | One brand name or website as plain text, or an array of up to 10 brands or domains. Each target costs 15 credits. |
platform | "google" | "chat_gpt" | |
location_code | integer | DataForSEO location code. Default 2840 (US). |
language_code | string |
curl https://api.enrichlabs.ai/v1/geo/mentions \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"queries": [
"acme.io",
"rivalco.com"
],
"platform": "chat_gpt"
}'{
"mentions": [
{
"query": "acme.io",
"target": {
"domain": "acme.io"
},
"mentions": 154,
"ai_search_volume": 2022,
"top_source_domains": [
{
"domain": "www.acme.io",
"mentions": 33,
"ai_search_volume": 301
},
{
"domain": "www.reddit.com",
"mentions": 16,
"ai_search_volume": 145
}
]
}
]
}Keyword research
Keyword ideas with monthly search volume, competition and top-of-page bid range from Google Ads Keyword Planner.
Body
| Field | Type | Notes |
|---|---|---|
keywordsrequired | string[] | Seed keywords. 1 to 20 items |
location_code | string | Google Ads geo target constant. Default "2840" (US). |
language_code | string | Google Ads language constant. Default "1000" (English). |
limit | integer | Default 50. 1 to 100 |
curl https://api.enrichlabs.ai/v1/keywords \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"ai marketing agent"
],
"limit": 20
}'{
"keywords": [
{
"keyword": "ai marketing agency",
"avg_monthly_searches": 2400,
"competition": "LOW",
"competition_index": 20,
"top_of_page_bid_low": 6.23,
"top_of_page_bid_high": 25.85,
"monthly_searches": [
{
"year": 2026,
"month": "SEPTEMBER",
"searches": 2900
}
]
}
]
}Web search results
Live organic web results for a query.
Body
| Field | Type | Notes |
|---|---|---|
queryrequired | string | |
limit | integer | Default 10. 1 to 10 |
country | string | Two-letter country code. |
curl https://api.enrichlabs.ai/v1/serp \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "best ai marketing agent",
"limit": 10
}'{
"query": "best ai marketing agent",
"results": [
{
"position": 1,
"title": "Marketers, what's the best AI agent?",
"url": "https://www.reddit.com/r/DigitalMarketing/comments/...",
"snippet": "I've used Gemini, Claude and ChatGPT with varied results..."
}
]
}Meta ad search
Search 150K scaling Meta ads from 55K brands by copy, brand, industry, creative angle, country and performance, ranked by days running or EU reach. Each ad has copy, media, landing page and per-country reach (eu_reach is null for ads that never ran in the EU). Variants of the same ad are collapsed.
Body
| Field | Type | Notes |
|---|---|---|
query | string | Words to find in the ad copy or brand name. |
brands | string[] | Brand names to include. 1 to 10 items |
industries | string[] | One of: apparel, beauty, home, food_beverage, media, financial_services, travel, delivery, restaurants, retail, pets, technology, automotive, outdoors, family, publishing. At least 1 item |
angles | string[] | Creative angles, e.g. before-after or social-proof. One of: before-after, founder-story, social-proof, comparison, offer-led, problem-solution, launch, demo-how-to, educational, benefits, product-features, lifestyle-aspiration, seasonal-gifting, product-showcase. At least 1 item |
media_type | "video" | "image" | "text" | |
countries | string[] | Targeted countries, ISO 2-letter codes. 1 to 20 items |
min_days_running | integer | 1 to 3650 |
min_eu_reach | integer | At least 1 |
sort | "days_running" | "eu_reach" | "newest" | Default days_running. |
limit | integer | Default 20. 1 to 50 |
curl https://api.enrichlabs.ai/v1/ads/search \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "protein",
"industries": [
"food_beverage"
],
"angles": [
"social-proof",
"before-after"
],
"countries": [
"US"
],
"min_days_running": 30,
"sort": "days_running",
"limit": 10
}'{
"ads": [
{
"id": "trendtrack:1234567890",
"brand": "Acme Nutrition",
"title": "The protein shake 40,000 runners switched to",
"copy": "The protein shake 40,000 runners switched to. 30g protein, no bloat. Try it risk-free for 30 days.",
"angle": "social-proof",
"industry": "food_beverage",
"media_type": "video",
"days_running": 212,
"eu_reach": 1840210,
"variants": 14,
"reach_by_country": {
"DE": 802113,
"FR": 512004
},
"countries": [
"US",
"DE",
"FR"
],
"first_seen": "2026-02-03T09:12:44Z",
"landing_url": "https://acmenutrition.com/products/shake",
"thumbnail_url": "https://agent.enrichlabs.ai/api/documents/download?path=...",
"video_url": "https://agent.enrichlabs.ai/api/documents/download?path=..."
}
]
}Meta Ad Library intel
Active Meta ads for competitors, grouped by creative angle and hook. Facebook page URLs or Page IDs are exact; brand names are matched by search.
Body
| Field | Type | Notes |
|---|---|---|
competitorsrequired | string[] | Page URLs, Page IDs or brand names. 1 to 5 items |
country | string | |
max_ads | integer | Per competitor. Default 10. 1 to 20 |
curl https://api.enrichlabs.ai/v1/ads/library \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"competitors": [
"https://www.facebook.com/rivalco"
],
"max_ads": 10
}'{
"status": "success",
"count": 5,
"competitor_results": [
{
"competitor": "https://www.facebook.com/rivalco",
"search_mode": "page",
"ads_found": 5,
"error": null
}
],
"top_ads": [
{
"competitor": "https://www.facebook.com/rivalco",
"page_name": "Rivalco",
"ad_id": "894522480402662",
"body": "Steal this stack...",
"creative_angle": "social proof"
}
],
"top_hooks": [
"steal this stack"
],
"creative_angle_distribution": {
"social proof": 3,
"price": 2
}
}Buying-intent signals
Recent Reddit and X posts about your keywords, each scored 0 to 100 for buying intent with a one-line reason.
Body
| Field | Type | Notes |
|---|---|---|
keywordsrequired | string[] | Topics, product categories or competitors. 1 to 5 items |
platforms | ("reddit" | "twitter")[] | At least 1 item |
days | integer | Default 14. 1 to 30 |
subreddits | string[] | Limit Reddit to these subreddits. 0 to 10 items |
limit | integer | Posts per platform. Default 25. 1 to 50 |
curl https://api.enrichlabs.ai/v1/intent/signals \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": [
"ai marketing agent",
"marketing automation for startups"
],
"platforms": [
"reddit"
],
"days": 7
}'{
"signals": [
{
"platform": "reddit",
"url": "https://www.reddit.com/r/LawFirmMarketing/comments/...",
"title": "CRM Recommendations",
"text": "We are looking to move on from Clio Grow and are looking at Lawmatics, Law Ruler, HubSpot...",
"author": "612Injured",
"created_at": "2026-09-30T17:24:59+00:00",
"engagement": 40,
"intent_score": 95,
"intent": "comparing",
"reason": "Actively evaluating named CRM vendors to switch"
}
]
}Buyer Intent Radar
Find current buyer conversations relevant to what you sell. Examines up to 25 public posts per platform from the last seven days, returning only matching opportunities. Zero matches are valid and billable. Does not contact anyone or verify buyers.
Body
| Field | Type | Notes |
|---|---|---|
product_descriptionrequired | string | Describe your product or service, intended customers and relevant pricing constraints. Distinguish software from human services so hiring requests are assessed correctly. |
topicrequired | string | One product category or competitor, e.g. AI video generator or Higgsfield. Results depend on the supplied search topic and provider coverage. |
platformrequired | "reddit" | "twitter" | "both" | reddit for Reddit, twitter for X, or both. Each platform examines up to 25 posts; matching opportunities may be fewer or zero. |
curl https://api.enrichlabs.ai/v1/intent/opportunities \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_description": "Affordable paid AI video software for creators and ecommerce teams, with API access.",
"topic": "AI video generator",
"platform": "reddit"
}'{
"topic": "AI video generator",
"platforms": [
"reddit"
],
"window": {
"since": "2026-10-31",
"until": "2026-11-07"
},
"posts_examined": 6,
"opportunities": [
{
"platform": "reddit",
"url": "https://www.reddit.com/r/ClaudeAI/comments/1xnpi88/claude_for_social_marketing_looking_for_ai_video/",
"title": "Looking for an AI video generator",
"text": "Looking for an affordable video model with API access.",
"author": null,
"created_at": "2026-11-04T14:24:15+00:00",
"engagement": null,
"intent_score": 90,
"intent": "buying",
"reason": "Seeking an affordable video model with API access."
}
]
}Google reviews
Rating, review count and the newest Google reviews (last 12 months) for a business, flagging negative reviews without an owner reply.
Body
| Field | Type | Notes |
|---|---|---|
business_namerequired | string | |
locationrequired | string | City and region, e.g. "Austin, TX". |
websiterequired | string | Confirms the Google profile belongs to this business. |
curl https://api.enrichlabs.ai/v1/reviews \
-H "Authorization: Bearer $ENRICH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"business_name": "Acme Coffee",
"location": "Austin, TX",
"website": "https://acmecoffee.com"
}'{
"profile": "Acme Coffee",
"url": "https://www.google.com/maps/search/?api=1&query=Acme%20Coffee",
"rating": 4.7,
"review_count": 312,
"reviews": [
{
"stars": 2,
"date": "2026-10-02",
"text": "Waited 20 minutes for a latte.",
"owner_replied": false
}
],
"unanswered_negative": [
{
"stars": 2,
"date": "2026-10-02",
"text": "Waited 20 minutes for a latte.",
"owner_replied": false
}
]
}