Influencer API and MCP server

What you can query

Creator search accepts the same filters as the product: followers, average views and likes, engagement rate, posting cadence, promotion and sponsorship counts, language, hashtags, country, category, email availability and more.

Example request and response

Search is free and returns IDs. Authenticate with your API key in the x-ty-api-key header:

curl -X GET "https://api.topyappers.com/api/v2/creators/search?source=instagram&country=France&page=1&perPage=10" \
  -H "x-ty-api-key: $TY_API_KEY"

Then fetch full profiles for the IDs you need:

curl -X POST "https://api.topyappers.com/api/v2/creators/get" \
  -H "Content-Type: application/json" \
  -H "x-ty-api-key: $TY_API_KEY" \
  -d '{"userIds": ["UCECuDLnD9j3y901oNxJFerw"]}'

Profiles come back in response.data, in snake_case. A trimmed example from the docs:

{
  "message": "OK",
  "response": {
    "data": [
      {
        "user_id": "UCECuDLnD9j3y901oNxJFerw",
        "handle": "April Apple Tech",
        "source": "youtube",
        "categories": ["Tech Reviews", "Gadget Reviews", "Smartphone Comparisons"],
        "followers": 2500,
        "avg_views": 35,
        "engagement_rate": 0.11,
        "promoted_products": ["DIHRAMS", "iphone"],
        "best_promotion_niches": ["Consumer Electronics", "Mobile Devices", "Tech Accessories"],
        "main_category": "Technology",
        "country": "United Arab Emirates",
        "language": "english",
        "uploads_per_month": 1.66,
        "promotions_count": 2
      }
    ],
    "page": 1,
    "next_page": 0
  }
}

Full parameter and field references are in the API docs.

Use it from AI agents: the MCP server

The topYappers MCP server lets AI assistants call the same data as tools: search creators (free), fetch profiles, search viral content and videos, look up song charts, and read your outreach projects and messages. Add it to Claude Code with one command:

claude mcp add --transport http topyappers https://mcp.topyappers.com/mcp \
  --header "Authorization: Bearer YOUR_TOPYAPPERS_API_KEY"

It also works as a custom connector in Claude and with other MCP-compatible clients. Setup for each client is on our MCP page.

Rate limits and credits

• 60 requests per minute per API key. Above that you get a 429 with a Retry-After header.
• Credits are deducted per creator profile, video or song request, as in the table above. Every response includes your remaining balance in the x-ty-credits header, plus rate-limit headers.
• Top up credits and manage keys from the API page in your account. If you need higher limits, contact support.

Common use cases

• Agency dashboards: pull creator profiles and promotion history into your own reporting.
• Enrichment: add engagement, categories and promotion data to creator lists you already have.
• Internal search tools: build a creator search for your team on top of the free search endpoint.
• AI agents: let an assistant shortlist creators, draft outreach and read replies through MCP.