Flinque Developer API: Build Custom Influencer Marketing Workflows
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.
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.
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.
Authenticate your request
Include your API key as a Bearer token in the Authorization header of every request: Authorization: Bearer YOUR_KEY
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.
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.
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
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.
Search and filter creators
Fake follower detection
Manage creator lists
Send bulk messages
Track campaign performance
Account and user data
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.
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.
creator.verified
Fires when a creator’s verification status changes, such as after a fake follower re-scan.
outreach.replied
Fires when a creator responds to an outreach message you sent through Flinque.
campaign.milestone
Fires when campaign metrics hit configured thresholds like conversion counts or engagement benchmarks.
list.updated
Fires when a team member adds, removes, or modifies creators in a shared list.
{
"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.
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.
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.
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.
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.
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.
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.
{
"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"
}
}
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.
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.