INinstantly
AILeadFinderAgent

Suggest audiences from a campaign

Changed on

Analyze the leads already in a campaign and suggest SuperSearch audiences that match them. Each suggestion returns a natural-language query plus store-format filters. Rate limited per workspace.

Requires one of the following scopes: ai_agents:read, ai_agents:all, all:read, all:all

post/api/v2/ai-agents/lead-finder/suggest-audience

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/lead-finder/suggest-audience
  • Auth
    HTTP bearer

Request body

campaign_idstring uuid required

Campaign whose existing leads to analyze

countinteger

Number of suggestions (1-5)

Example request

{
  "campaign_id": "01a19e6d-8581-7b99-9ed4-69e24e377fed",
  "count": 3
}

Response

Audience suggestions derived from the campaign

campaign_idstring uuid required
analyzed_lead_countinteger required
total_lead_countinteger required
confidence'high' | 'low' required
profile_summarystring required

Example response

{
  "campaign_id": "0198c2a4-3f1e-7000-8000-000000000000",
  "analyzed_lead_count": 4820,
  "total_lead_count": 4820,
  "confidence": "high",
  "profile_summary": "Mostly VP/Director-level Sales leaders at US B2B software companies.",
  "suggestions": [
    {
      "label": "Same profile",
      "query": "VP of Sales at US software companies, 50-200 employees",
      "rationale": "Matches the dominant title, industry, size and geo in this campaign."
    }
  ]
}

Changes