Help Centre / Developer API

Flinque Developer API: Build Custom Influencer Marketing Workflows

Help Centre · Developer API

The Flinque API is a REST-based developer interface that lets you pull creator data, audience demographics, authenticity scores, and campaign metrics into any software you build. Authenticate with OAuth 2.0 or API keys, call JSON endpoints, subscribe to webhooks, and build custom integrations for your brand, agency, or SaaS product. Available on all paid plans.

REST API with JSON|OAuth 2.0 + API keys|Webhooks supported
REST
JSON over HTTPS
20+
Core endpoints
99.9%
Target uptime SLA
Free
On all paid plans

Quick Start: Make Your First API Call in Under 2 Minutes

You need a Flinque account on a paid plan, an API key, and a terminal or HTTP client. Here is the 3-step process to get your first creator search running.

01

Generate your API key

Log in to your Flinque dashboard, go to Settings > Developer > API Keys, and click “Generate new key”. Copy the key and store it securely.

02

Authenticate your request

Include your API key as a Bearer token in the Authorization header of every request: Authorization: Bearer YOUR_KEY

03

Make your first call

Send a GET request to the creator search endpoint. The response comes back as JSON with creator profiles, engagement scores, and audience metrics.

Your First API Call
curl -X GET "https://api.flinque.com/v1/creators/search?niche=fitness&country=us&min_followers=10000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

How to Authenticate With the Flinque API

The Flinque API supports two authentication methods. Use API keys for server-to-server integrations and OAuth 2.0 when building apps that act on behalf of other Flinque users.

Method 01

API Keys (Bearer Tokens)

Best for internal tools, data pipelines, and custom dashboards where you control both ends of the integration.

  • Generate in dashboard Settings > Developer
  • Include as Bearer token in Authorization header
  • Rotate keys anytime without downtime
  • Scoped to your workspace and plan limits
Method 02

OAuth 2.0

Best for third-party apps that need to access data across multiple Flinque customer accounts with user consent.

  • Register your app for client ID and secret
  • Standard OAuth 2.0 authorization code flow
  • Scoped permissions per access token
  • Refresh tokens for long-lived integrations

Core API Endpoints

Every Flinque API endpoint follows REST conventions. Base URL for all endpoints is https://api.flinque.com/v1. Here are the 20+ endpoints you can use, grouped by what they do.

Creator Discovery

Search and filter creators

GET /v1/creators/search
GET /v1/creators/{id}
GET /v1/creators/{id}/audience
GET /v1/creators/{id}/posts
Authenticity & Verification

Fake follower detection

GET /v1/creators/{id}/verify
GET /v1/creators/{id}/engagement
GET /v1/creators/{id}/authenticity
Lists & Shortlists

Manage creator lists

GET /v1/lists
POST /v1/lists
POST /v1/lists/{id}/creators
DELETE /v1/lists/{id}
Outreach

Send bulk messages

GET /v1/outreach/templates
POST /v1/outreach/messages
GET /v1/outreach/messages/{id}
Campaigns

Track campaign performance

GET /v1/campaigns
POST /v1/campaigns
GET /v1/campaigns/{id}/metrics
Workspace & Teams

Account and user data

GET /v1/workspace
GET /v1/team/members
GET /v1/usage

Code Examples in Multiple Languages

Here is how to search for creators in the fitness niche based in the United States with at least 10,000 followers, using three common programming languages.

Bash / cURL

curl -X GET "https://api.flinque.com/v1/creators/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -G \
  --data-urlencode "niche=fitness" \
  --data-urlencode "country=us" \
  --data-urlencode "min_followers=10000" \
  --data-urlencode "max_fake_follower_percent=10"

JavaScript (Node.js / Browser)

const params = new URLSearchParams({
  niche: 'fitness',
  country: 'us',
  min_followers: 10000,
  max_fake_follower_percent: 10
});

const response = await fetch(
  `https://api.flinque.com/v1/creators/search?${params}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Accept': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data.creators);

Python

import requests

response = requests.get(
    'https://api.flinque.com/v1/creators/search',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Accept': 'application/json'
    },
    params={
        'niche': 'fitness',
        'country': 'us',
        'min_followers': 10000,
        'max_fake_follower_percent': 10
    }
)

creators = response.json()['creators']
for creator in creators:
    print(creator['username'], creator['followers'])

API Rate Limits by Plan

Rate limits protect the platform for all customers. Every API response includes X-RateLimit-Remaining and X-RateLimit-Reset headers so you can handle limits gracefully.

Plan
Requests/Day
Requests/Minute
Burst Allowance
Free Plan
Limited endpoints
100
10
Not available
Starter Plan
$49/month
10,000
60
100 (5-min window)
Enterprise Plan
$150/month
100,000
300
500 (5-min window)

Hitting a rate limit returns HTTP 429 with a Retry-After header. Enterprise customers can request custom rate limits for specific use cases. See all plan details.

Webhooks for Real-Time Events

Instead of polling our API for updates, subscribe to webhooks and receive HTTP POSTs to your server whenever something changes. Every webhook includes an HMAC signature so you can verify it actually came from Flinque.

Event Type

creator.verified

Fires when a creator’s verification status changes, such as after a fake follower re-scan.

Event Type

outreach.replied

Fires when a creator responds to an outreach message you sent through Flinque.

Event Type

campaign.milestone

Fires when campaign metrics hit configured thresholds like conversion counts or engagement benchmarks.

Event Type

list.updated

Fires when a team member adds, removes, or modifies creators in a shared list.

Example Webhook Payload
{
  "event": "outreach.replied",
  "timestamp": "2026-04-23T14:22:35Z",
  "data": {
    "message_id": "msg_8a7f2c9e",
    "creator_id": "cr_4d2e8f1a",
    "creator_username": "fitness_maven",
    "platform": "instagram",
    "campaign_id": "camp_5b3c9e7d"
  }
}

What You Can Build With the Flinque API

The API unlocks integrations and workflows beyond what the dashboard alone provides. Here are the most common use cases our developer customers build.

Use Case 01

Custom internal dashboards

Pull creator data into your company’s BI tool (Looker, Tableau, Metabase) to combine influencer metrics with sales, ad spend, and customer data in one unified view.

Use Case 02

Automated creator vetting

Pipe creator handles from your CRM or spreadsheet into Flinque’s verification endpoints to automatically check fake followers and engagement quality at scale.

Use Case 03

Agency client reporting

Agencies managing multiple brand clients can build automated white-label reports that pull creator performance data directly from Flinque into branded PDF outputs.

Use Case 04

SaaS product integrations

If you build software for brands, agencies, or creators, the Flinque API lets you embed creator data, audience analytics, and verification directly into your product.

Use Case 05

Automated outreach workflows

Trigger personalized outreach sequences based on events in your CRM or eCommerce platform. Send templated messages when specific creator criteria are met.

Use Case 06

Data warehouse sync

Schedule daily or hourly pulls of creator data into Snowflake, BigQuery, or Redshift to power advanced analytics across your marketing organization.

Error Handling and HTTP Status Codes

The Flinque API uses standard HTTP status codes and returns error details in a consistent JSON structure so your code can handle failures gracefully.

Code
Meaning
What to do
200
Success
Request succeeded, parse response body
400
Bad Request
Check request parameters against the docs
401
Unauthorized
API key missing, invalid, or revoked
403
Forbidden
Your plan does not include this endpoint
404
Not Found
The creator or resource does not exist
429
Rate Limited
Wait for Retry-After header, then retry
500
Server Error
Retry with exponential backoff, contact support if persistent
Example Error Response
{
  "error": {
    "code": "invalid_filter",
    "message": "The 'min_followers' parameter must be a positive integer.",
    "request_id": "req_7f3a2d9e",
    "docs_url": "https://flinque.com/help-centre/api/#endpoints"
  }
}
SDKs & Libraries

Official SDKs coming soon

We are actively developing official SDKs for JavaScript/TypeScript, Python, and Ruby to reduce boilerplate and handle auth, retries, and pagination automatically. Expected release: Q3 2026. Meanwhile, any HTTP client library works with the Flinque API since it follows standard REST conventions.

Start Building

Generate your API key and start building today

The Flinque API is included free on Starter and Enterprise plans. Create an account, generate a key, and start pulling verified creator data into your own software in minutes.

Developer API FAQs

Does Flinque have a public API?

Yes. The Flinque REST API is available on all paid plans (Starter at $49/month and Enterprise at $150/month). It supports JSON responses, OAuth 2.0 and API key authentication, and webhooks for real-time events. Base URL is https://api.flinque.com/v1.

How do I get a Flinque API key?

Log in to your Flinque dashboard, navigate to Settings > Developer > API Keys, and click “Generate new key”. Copy the key immediately because we only show it once for security. You can rotate keys anytime without downtime.

What are the Flinque API rate limits?

Rate limits depend on your plan. Free Plan allows 100 requests per day. Starter Plan allows 10,000 requests per day with 60 per minute. Enterprise Plan allows 100,000 requests per day with 300 per minute and priority queue access. Enterprise customers can request custom limits for specific use cases.

Does Flinque offer SDKs?

Official SDKs for JavaScript/TypeScript, Python, and Ruby are planned for Q3 2026 release. In the meantime, any standard HTTP client library works with the Flinque API since all endpoints follow REST conventions with JSON responses.

Can I build a commercial product using the Flinque API?

Yes. SaaS platforms, agencies, and brand tools can build commercial products using the Flinque API. Enterprise plan is required for high-volume use cases and reselling. Contact our team to discuss commercial integration terms.

What data can I access through the API?

The Flinque API provides access to creator profiles across Instagram, TikTok, YouTube, and X, including audience demographics, engagement metrics, fake follower scores, authenticity ratings, content performance, outreach management, and campaign tracking data. Full endpoint documentation is available above in the Core Endpoints section.

How does Flinque handle API security?

All API traffic runs over HTTPS with TLS 1.2+. Authentication uses OAuth 2.0 or Bearer tokens. Webhook payloads include HMAC-SHA256 signatures so you can verify authenticity. API keys are workspace-scoped and can be rotated or revoked at any time from your dashboard.

Where can I get help if I get stuck?

Visit our Help Centre for setup guides, check Integrations documentation for native connector setup, or contact our support team. Enterprise customers get priority API support with dedicated Slack channel access on request.