> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/use-cases/influencer-data-api>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/use-cases/influencer-data-api.mdx>

---

# Influencer data API

Live creator profiles, post history, and engagement inputs for vetting, rate cards, and campaign reports — Instagram, TikTok, YouTube, one schema.

Influencer tools need fast answers: does the handle exist, what do they post, is engagement plausible, what did the last sponsored post look like?

CSV imports fail at scale — three networks, three pagination models, three breakage surfaces per layout change. You have the scoring logic; you need current profile and post data in one ingestible shape.

## Endpoints

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/v1/tiktok/users/search` | Seed discovery lists from a keyword when a brand brief names a niche, not a handle. |
| GET | `/v2/instagram/profiles/{profile}` | Profile card for vetting: follower count, bio, external links, verification status. |
| GET | `/v2/instagram/profiles/{profile}/media` | Paginated feed posts — pull likes and comments to compute engagement rate on your side. |
| GET | `/v2/instagram/profiles/{profile}/media?tab=reels` | Recent Reels for short-form creators where feed posts understate actual reach. |
| GET | `/v1/tiktok/profiles/{handle}/videos` | TikTok upload history with view and engagement fields for sponsorship vetting. |
| GET | `/v1/tiktok/profiles/{handle}/followers` | Follower sample for audience-quality models — flag empty bios, default avatars, odd ratios. |
| GET | `/v1/youtube/channel` | Channel subscriber count and metadata from a URL or handle for rate-card lookups. |
| GET | `/v1/youtube/channels/videos` | Recent uploads with view counts — baseline performance before quoting a integration fee. |

## Workflow

1. **Import the shortlist.** Handles arrive from brand uploads, marketplace exports, or your own discovery search. Store platform + handle pairs; do not assume @names match across networks.
2. **Hydrate profile records.** Hit profile endpoints to fill CRM fields — avatar, bio, follower count, verification. Respect lookupStatus: not_found means the account is gone; completed lookups charge credits either way.
3. **Pull post history for vetting.** Fetch recent posts, Reels, or videos before approval. Your team (or your classifier) checks sponsored-content frequency, category fit, and engagement relative to follower count.
4. **Feed fraud and audience models.** Pass follower samples and engagement time series into your fake-follower scoring. Social Fetch returns the inputs; your thresholds stay in your product.
5. **Snapshot and report campaigns.** Store a pre-campaign baseline, then re-pull post metrics after deliverables go live. Compare actual views and engagement against the rate you quoted — credits do not expire between campaign bursts.

## Example: pull recent Instagram posts for engagement math

```bash
curl -sS \
  -H "x-api-key: YOUR_API_KEY" \
  "https://api.socialfetch.dev/v2/instagram/profiles/mkbhd/media"
```

## Why influencer platforms wire data here

- Same response envelope on Instagram, TikTok, YouTube, and 9+ more — one ingestion path for profile cards and post history.
- Pay-as-you-go credits, no required subscription: refresh 50 creators before a pitch deck without a monthly minimum.
- 100 free credits to run real handles through your vetting pipeline before a bulk import.
- lookup_failed and 503 responses do not charge — you only pay for completed lookups.
- Operated by Social Freak Ltd, a registered UK company with documented data handling for enterprise procurement.
