Build with the InfluenceFlow API

A full-featured REST API and MCP server for AI agents. Discover creators, manage campaigns, process payments, and track performance programmatically.

REST API MCP Server API Key Auth OpenAPI 3.0

Quick Start

Get up and running in three simple steps. Generate your API key, authenticate, and start making requests.

1

Get Your API Key

Sign up for an InfluenceFlow account, then generate an API key from your Brand Dashboard under Tools → API Keys. Agencies: open your Agency Dashboard → API Keys and pick a brand.

# Your API key API_KEY="if_live_abc123..."
2

Authenticate

Include your API key in the Authorization header of every request.

Authorization: Bearer if_live_abc123...
3

Make Your First Request

Search creators, create campaigns, or fetch analytics with a single API call.

GET /api/v1/creators/ # Returns paginated creator list

Code Examples

Search and filter creators from the InfluenceFlow API using your preferred language.

# Search creators by platform and minimum follower count

curl -X GET "https://influenceflow.io/api/v1/creators/?platform=instagram&min_followers=10000" \
  -H "Authorization: Bearer if_live_abc123..." \
  -H "Content-Type: application/json"

# Example response
{
  "count": 142,
  "next": "https://influenceflow.io/api/v1/creators/?page=2",
  "results": [
    {
      "id": 1,
      "username": "creator_handle",
      "platform": "instagram",
      "followers": 52400,
      "engagement_rate": 3.8
    }
  ]
}
import requests

API_KEY = "if_live_abc123..."
BASE_URL = "https://influenceflow.io/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# Search creators by platform and minimum follower count
response = requests.get(
    f"{BASE_URL}/creators/",
    headers=headers,
    params={
        "platform": "instagram",
        "min_followers": 10000,
    },
)

data = response.json()
print(f"Found {data['count']} creators")

for creator in data["results"]:
    print(f"  @{creator['username']} - {creator['followers']} followers")
const API_KEY = "if_live_abc123...";
const BASE_URL = "https://influenceflow.io/api/v1";

// Search creators by platform and minimum follower count
async function searchCreators() {
  const params = new URLSearchParams({
    platform: "instagram",
    min_followers: "10000",
  });

  const response = await fetch(
    `${BASE_URL}/creators/?${params}`,
    {
      headers: {
        "Authorization": `Bearer ${API_KEY}`,
        "Content-Type": "application/json",
      },
    }
  );

  const data = await response.json();
  console.log(`Found ${data.count} creators`);

  data.results.forEach(creator => {
    console.log(`  @${creator.username} - ${creator.followers} followers`);
  });
}

searchCreators();

Resources & Scopes

Every resource is available under the base URL https://influenceflow.io/api/v1. A key with no scopes selected has full access.

Resource Path Scopes
Creators/creators/creators:read
Talent pools/talent-pools/creators:read / creators:write
Campaigns/campaigns/campaigns:read / campaigns:write
Creator discovery/campaigns/{id}/discovery/campaigns:read / campaigns:write
Product catalog/products/, /products/bulk/, /products/{id}/tracking-links/catalog:read / catalog:write
Offers/offers/offers:read / offers:write
Applications/applications/offers:read / offers:write
Collaborations/collaborations/collaborations:read / collaborations:write
Content approval/content/content:read / content:write
Payment milestones/milestones/payments:read / payments:write
Tracking links/tracking-links/analytics:read / campaigns:write
Analytics/analytics/analytics:read
Webhooks/webhooks/webhooks:manage

OAuth 2.0

In addition to API keys, the API accepts OAuth 2.0 bearer tokens with the same scopes. Register an OAuth application in your brand dashboard (Tools → OAuth Apps) and request a token with the client_credentials grant; authorization_code with PKCE is also supported. Agent clients can self-register via RFC 7591 dynamic registration at /o/register/ (authorization-code flow only; a brand approves access on the consent page).

POST https://influenceflow.io/o/token/ # grant_type=client_credentials&scope=campaigns:read

Discovery: /.well-known/oauth-authorization-server (RFC 8414), /.well-known/oauth-protected-resource (RFC 9728), /openapi.json

Rate limits

Standard keys allow 100 requests per minute and Enterprise keys 1,000. Creator search is capped at 20 per minute because it is the most expensive query. Exceeding a limit returns HTTP 429 with a Retry-After header.

Errors

Every error is JSON with a machine-readable code, a message, and a suggested fix. Unrecognised query parameters return 400 rather than being ignored, so a misspelled filter can never silently return unfiltered results.

{"error": {"code": "unknown_query_parameter", "message": "Unrecognised query parameter(s): 'max_follower'", "suggestion": "Did you mean: 'max_follower' should be 'followers_max'?"}}

Webhooks

Receive real-time notifications when events happen in InfluenceFlow. Configure webhook endpoints to keep your systems in sync.

POST /payments/webhook/

Stripe Webhooks

Get notified about payment events including successful charges, refunds, subscription updates, and payout completions. Secured with Stripe signature verification.

POST /integrations/instantly/webhook/

Instantly.ai Webhooks

Receive email campaign events including opens, replies, bounces, and lead status changes. Automatically syncs outreach activity with InfluenceFlow.

Get Your API Key

Create a free InfluenceFlow account to generate your API key and start building integrations today.

Sign Up & Get Your Key

We use essential cookies to make our site work. With your consent, we also use analytics cookies to understand how you use our site so we can improve it. Learn more