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.

Your first call
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.

Header
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.

EndpointCost
POST /geo/visibility1 per answer (prompts x platforms)
POST /aco/muse5 per answer (10 with a follow-up)
POST /geo/mentions15 per query
POST /keywords5 per call
POST /serp1 per call
POST /ads/search5 per call
POST /ads/library10 per competitor
POST /intent/signals20 per call
POST /intent/opportunities20 per platform (40 for both)
POST /reviews5 per call

Errors

Every error has the same shape:

Response (402)
{
  "error": {
    "type": "insufficient_credits",
    "message": "This call costs 5 credits. Buy more at https://platform.enrichlabs.ai."
  }
}
StatusTypeMeaning
400invalid_request_errorThe body failed validation.
401authentication_errorMissing, unknown or revoked key.
402insufficient_creditsBalance is below the call cost.
403permission_errorThe API is not enabled for this account.
404not_found_errorUnknown route, job or business.
429rate_limit_errorOver 60 requests per minute for this key.
502provider_errorAn 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 Code
claude mcp add --transport http enrich \
  https://api.enrichlabs.ai/v1/mcp \
  --header "Authorization: Bearer $ENRICH_API_KEY"
Other MCP clients
{
  "mcpServers": {
    "enrich": {
      "type": "http",
      "url": "https://api.enrichlabs.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${ENRICH_API_KEY}"
      }
    }
  }
}

Jobs

GET/jobs/{id}

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.

Response
{
  "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

POST/geo/visibility
1 per answer (prompts x platforms)Async job

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

FieldTypeNotes
brand_namerequiredstring
site_urlrequiredstring
queriesrequiredstring[]Prompts a buyer would ask an AI assistant. 1 to 20 items
competitorsstring[]Competitor brand names to track. 0 to 5 items
platforms("chatgpt-web" | "gemini-web")[]Defaults to both. At least 1 item
Request
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"
  ]
}'
Response (202)
{
  "id": "mcpjob_CdyhFBqgRvxEI_L4K5vw",
  "object": "job",
  "status": "running"
}

Ask Muse

POST/aco/muse
5 per answer (10 with a follow-up)Async job

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

FieldTypeNotes
questionrequiredstringWhat a shopper would ask Muse.
businessobjectBusiness to check the reply for: recommended, mentioned or absent.
followupstringAsked in the same chat after the reply.
Request
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?"
}'
Response (202)
{
  "id": "musejob_3f9c1a7e5b2d4c6f8a0e1b3d",
  "object": "job",
  "status": "running"
}

AI mentions index

POST/geo/mentions
15 per query

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

FieldTypeNotes
queriesrequiredstring | 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_codeintegerDataForSEO location code. Default 2840 (US).
language_codestring
Request
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"
}'
Response
{
  "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

POST/keywords
5 per call

Keyword ideas with monthly search volume, competition and top-of-page bid range from Google Ads Keyword Planner.

Body

FieldTypeNotes
keywordsrequiredstring[]Seed keywords. 1 to 20 items
location_codestringGoogle Ads geo target constant. Default "2840" (US).
language_codestringGoogle Ads language constant. Default "1000" (English).
limitintegerDefault 50. 1 to 100
Request
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
}'
Response
{
  "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

POST/serp
1 per call

Live organic web results for a query.

Body

FieldTypeNotes
queryrequiredstring
limitintegerDefault 10. 1 to 10
countrystringTwo-letter country code.
Request
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
}'
Response
{
  "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 Library intel

POST/ads/library
10 per competitor

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

FieldTypeNotes
competitorsrequiredstring[]Page URLs, Page IDs or brand names. 1 to 5 items
countrystring
max_adsintegerPer competitor. Default 10. 1 to 20
Request
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
}'
Response
{
  "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

POST/intent/signals
20 per call

Recent Reddit and X posts about your keywords, each scored 0 to 100 for buying intent with a one-line reason.

Body

FieldTypeNotes
keywordsrequiredstring[]Topics, product categories or competitors. 1 to 5 items
platforms("reddit" | "twitter")[]At least 1 item
daysintegerDefault 14. 1 to 30
subredditsstring[]Limit Reddit to these subreddits. 0 to 10 items
limitintegerPosts per platform. Default 25. 1 to 50
Request
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
}'
Response
{
  "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

POST/intent/opportunities
20 per platform (40 for both)

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

FieldTypeNotes
product_descriptionrequiredstringDescribe your product or service, intended customers and relevant pricing constraints. Distinguish software from human services so hiring requests are assessed correctly.
topicrequiredstringOne 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.
Request
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"
}'
Response
{
  "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

POST/reviews
5 per call

Rating, review count and the newest Google reviews (last 12 months) for a business, flagging negative reviews without an owner reply.

Body

FieldTypeNotes
business_namerequiredstring
locationrequiredstringCity and region, e.g. "Austin, TX".
websiterequiredstringConfirms the Google profile belongs to this business.
Request
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"
}'
Response
{
  "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
    }
  ]
}