REST API

Instagram Lead API
for Developers

Integrate Instagram lead generation directly into your apps. Simple REST API with predictable pricing.

5-15 min processing
No IG login required
99.9% uptime
Webhook support

API Access

API access is available exclusively on the Business plan.

Recommended

Business

$199/month

25,000 emails/month • 10 concurrent jobs

  • Full REST API access
  • 25,000 emails/month included
  • Dedicated support
  • Webhook callbacks
Subscribe

Need enterprise volume? Contact us for custom pricing.

Quickstart

Get started in minutes. Here is how to make your first API call.

1Create a lead extraction job

curl -X POST https://api.igleads.ai/v1/leads/competitors \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["nike", "adidas"],
    "limit": 1000,
    "filters": {
      "businessOnly": true,
      "minFollowers": 1000
    }
  }'

2Check job status

curl https://api.igleads.ai/v1/leads/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

3Get your leads

curl https://api.igleads.ai/v1/leads/jobs/job_abc123/results \
  -H "Authorization: Bearer YOUR_API_KEY"

Response format

{
  "success": true,
  "jobId": "job_abc123",
  "type": "competitors",
  "count": 1000,
  "leads": [
    {
      "id": "lead_xyz789",
      "username": "john_smith",
      "fullName": "John Smith",
      "email": "john@example.com",
      "phone": "+1234567890",
      "followers": 15420,
      "following": 892,
      "engagementRate": 3.2,
      "category": "Business",
      "website": "https://johnsmith.com",
      "bio": "Entrepreneur | Speaker | Author",
      "city": "New York",
      "isVerified": false,
      "isBusiness": true,
      "isPrivate": false,
      "lastActiveAt": "2025-01-14T10:30:00Z"
    }
  ]
}

API Endpoints

Base URL: https://api.igleads.ai

POST/v1/leads/competitors

Extract followers from Instagram accounts

POST/v1/leads/hashtag

Find users who posted with specific hashtags

POST/v1/leads/location

Extract leads from specific locations

POST/v1/leads/hotAI

Find users with purchase intent (AI-powered)

POST/v1/leads/network

See who accounts are following

POST/v1/leads/enrich

Enrich and filter existing user IDs

GET/v1/leads/jobs/:jobId

Get job status and progress

GET/v1/leads/jobs/:jobId/results

Get job results (leads data)

DELETE/v1/leads/jobs/:jobId

Delete a job and its data

Authentication

All API requests require a Bearer token in the Authorization header.

API Key

Include your API key in all requests using the Authorization header:

Authorization: Bearer YOUR_API_KEY

Security: Never expose your API key in client-side code. Always make API calls from your backend.

Available Filters

Use these filters to target specific types of leads.

ParameterTypeDescription
businessOnlybooleanOnly return business accounts
verifiedOnlybooleanOnly return verified accounts
minFollowersnumberMinimum follower count
maxFollowersnumberMaximum follower count
minEngagementnumberMinimum engagement rate (%)
maxEngagementnumberMaximum engagement rate (%)
activeWithinDaysnumberLast active within N days
categoriesstring[]Business categories to include
bioKeywordsstring[]Keywords that must appear in bio
excludeBioKeywordsstring[]Keywords to exclude from bio
intentKeywordsstring[]Intent keywords for hot leads (POST /hot only)

Ready to integrate?

Get your API key and start extracting leads in minutes.

Get API Key