arrow_back Growth Intel

Developer Portal & API

Growth Intel Developer & API Documentation

Programmatic and agentic access to Growth Intel's revenue intelligence engine, behavioral intent scoring, and omni-channel ad conversion pipelines.

OpenAPI Spec (JSON) OpenAPI Spec (YAML) llms.txt (Standard) Agent Instructions MCP Stream Endpoint

1. Authentication & Sandbox Environment

All production REST API requests require a per-tenant Bearer token in the Authorization header.

verified

Instant Sandbox Mode for Autonomous Agents

AI agents and developers can test all endpoints immediately without signing up or requesting manual approval using our public sandbox demo key:

Authorization: Bearer gi_sandbox_live_demo_key

2. Core API Endpoints

GET /api/v1

Returns API service health, active endpoint catalog, and OpenAPI references.

curl -sS https://growthintel.net/api/v1
POST /api/v1/leads

Ingest an inbound prospect from ads, webhooks, or landing pages. Computes real-time intent score (0-100) and triggers instant routing.

curl -sS -X POST https://growthintel.net/api/v1/leads \
  -H "Authorization: Bearer gi_sandbox_live_demo_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "meta_ads",
    "campaign_id": "1202094829384",
    "metadata": {
      "industry": "Healthcare",
      "company_size": "50-200"
    }
  }'
GET /api/v1/leads/semantic-search?q={query}

Vector search across leads using 1536-dimensional embeddings. Ranks matches by cosine distance.

curl -sS "https://growthintel.net/api/v1/leads/semantic-search?q=SaaS+exploring+CRM" \
  -H "Authorization: Bearer gi_sandbox_live_demo_key"
POST /api/v1/webhooks/conversions

Ingest closed-deal revenue feedback. Feeds conversion signals to Google Ads and Meta Ads smart bidding.

curl -sS -X POST https://growthintel.net/api/v1/webhooks/conversions \
  -H "X-Conversion-Secret: your_conversion_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": 1042,
    "value": 12500.00,
    "currency": "USD"
  }'

3. Model Context Protocol (MCP) Server

For autonomous LLMs and agent frameworks (Claude Desktop, Cursor, Gemini Agents, LangChain), Growth Intel provides a native MCP server:

Endpoint: https://growthintel.net/mcp/leads

Available Tools:

  • search-leads-tool: Filter leads by status, source, intent score, budget.
  • search-leads-by-natural-language-tool: Semantic query across lead intent.
  • campaign-performance-tool: Ad spend, lead count, and ROAS metrics.
  • pipeline-overview-tool: Deal pipeline stages and aggregate counts.
  • creative-performance-tool: Ad creative asset conversion rankings.

4. Official CLI Tool

Automate and inspect Growth Intel directly from the command line: 

# One-line installer:
curl -fsSL https://growthintel.net/install.sh | bash

# Or run with Node:
growthintel status --token=gi_sandbox_live_demo_key
growthintel leads search "high intent SaaS"

5. Structured Error Handling

All API errors return machine-readable JSON containing error codes, descriptive messages, and actionable resolution hints: 

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API token.",
    "resolution_hint": "Provide a valid token via 'Authorization: Bearer <API_TOKEN>'. For automated testing, use sandbox token 'gi_sandbox_live_demo_key'."
  }
}