Implementation guide

Build an Influencer Discovery Tool

Step-by-step guide to building an influencer discovery system with search filters, ranking logic, and the Influencer Marketing API.

Overview

A discovery tool combines search UI, API integration, filtering, and ranking. The API handles data; your product handles UX and business rules.

Architecture

Frontend search UI

Filters for niche, followers, platform, engagement.

Backend API proxy

Secure server holding your X-Api-Key.

Filtering engine

Business rules on top of API results.

Ranking layer

Sort by engagement, growth, or custom score.

Filters you can expose in your UI

Map user-facing controls to POST /search/newv1/ filter objects—the API handles the heavy lifting.

Follower range and engagement rate
Platform (Instagram, TikTok, YouTube)
Category, keywords, and topic tags
Location and language
Audience demographics and credibility
Email / contact availability

After search, enrich with profile and analytics endpoints for vetting workflows.

Workflow

1

User inputs niche and filter criteria in your UI

2

Backend calls POST /search/newv1/ with structured filters

3

System filters results by engagement thresholds

4

Ranked list displayed in dashboard or export

Example implementation

const response = await fetch("https://socapi.icu/v2.0/api/search/newv1/", {
  method: "POST",
  headers: {
    "X-Api-Key": process.env.INFLUENCIFY_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    filter: {
      followers: { left_number: 10000, right_number: 500000 },
      engagement_rate: { value: 0.03, operator: "gte" },
    },
    sort: { field: "engagement_rate", direction: "desc" },
  }),
});

const { accounts } = await response.json();
const ranked = accounts
  .filter((a) => a.user_profile.engagement_rate >= 3)
  .slice(0, 50);

Output structure

{
  "id": "creator_123",
  "username": "fitness.creator",
  "followers": 128400,
  "engagement_rate": 3.9,
  "category": "fitness",
  "platform": "instagram"
}

Profile enrichment

import requests

url = "https://socapi.icu/v2.0/api/reports/new/"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "username": "creator_handle",
    "platform": "instagram",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
Ship faster

Use cases

  • SaaS discovery tools for brands and agencies
  • Internal agency dashboards for campaign planning
  • CRM enrichment with creator profile data
Full documentation
Discovery tool dashboard

Why Choose Influencify API?

Enterprise-grade influencer data infrastructure with unmatched coverage and reliability

1-2 days

Typical integration

400M+

Searchable profiles

JSON

Response format