AI-Powered Creator Search

Search for creators using natural language queries. The AI understands intent and context to match creators based on content themes, audience demographics, and style.

The response includes a search_id that can be used with GET /v1/search/{id} to paginate through results for free.

Use cases:

• Find creators in a specific niche (“vegan food bloggers in LA”)
• Discover creators with specific audience characteristics (“fitness influencers with millennial audience”)
• Search by content style (“creators who post cinematic travel videos”)

Also callable as the search_creators MCP tool — see the MCP server guide for setup.

Pricing: 25 credits base + 2 credits per creator returned

POST /v1/search

cURL

cURL

curl --request POST \
  --url https://api.influship.com/v1/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "query": "fitness influencers who post workout videos"
}
'

200

{
  "data": [
    {
      "creator": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Jane Fitness",
        "bio": "Fitness coach & wellness advocate",
        "avatar_url": "https://cdn.example.com/avatars/jane.jpg"
      },
      "relevant_profile": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "platform": "instagram",
        "username": "fitness_coach_jane",
        "url": "https://www.instagram.com/fitness_coach_jane",
        "followers": 125000,
        "engagement_rate": 3.5,
        "is_verified": true,
        "data_updated_at": "2026-07-20T12:00:00.000+00:00"
      },
      "primary_profile": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "platform": "instagram",
        "username": "fitness_coach_jane",
        "url": "https://www.instagram.com/fitness_coach_jane",
        "followers": 125000,
        "engagement_rate": 3.5,
        "is_verified": true,
        "data_updated_at": "2026-07-20T12:00:00.000+00:00"
      },
      "match": {
        "score": 0.85,
        "confidence": 0.85,
        "low_confidence": false,
        "reasons": [
          "Active fitness content creator",
          "High engagement on workout posts"
        ],
        "evidence": [
          {
            "text": "Publishes ingredient-education Reels on sensitive-skin routines.",
            "provenance": "post_evidence",
            "fact_id": "<string>",
            "source_post_id": "<string>",
            "evidence_quote": "Today we break down why fragrance wrecks a sensitive-skin barrier…"
          }
        ],
        "ranking_source": "reranked"
      },
      "location_unverified": true
    }
  ],
  "search_id": "123e4567-e89b-12d3-a456-426614174000",
  "total": 87,
  "has_more": true,
  "next_cursor": "eyJvZmZzZXQiOjI1fQ==",
  "quality": {
    "mode": "reranked",
    "reason": null
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

AI-powered semantic search request

AI-powered semantic search request

query · string · required

Natural language search query

Required string length: 1 - 500

Example:

"fitness influencers with 100k+ followers who post workout videos"

platforms · enum<string>[]

Filter results to specific platforms

Social media platform

Available options: instagram

Example:

["instagram"]

filters · object

Additional filters

Show child attributes

limit · integer · default: 25

Maximum results to return

Required range: 1 <= x <= 100

Example:

25

creator_kinds · enum<string>[]

Restrict results to specific creator kinds (e.g. INFLUENCER vs THEME_PAGE). Omit for no filter.

Minimum array length: 1

Available options: INFLUENCER, THEME_PAGE

Example:

["INFLUENCER"]

Response

200

application/json

Successful response

data · object[] · required

Show child attributes

search_id · string<uuid> · required

Search ID. Use with GET /v1/search/{id} for free pagination.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Example:

"123e4567-e89b-12d3-a456-426614174000"

total · integer · required

Total number of results across all pages

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

87

has_more · boolean · required

Whether more results are available

Example:

true

next_cursor · string | null · required

Cursor for the next page

Example:

"eyJvZmZzZXQiOjI1fQ=="

quality · object

Whether results were fully AI-reranked, partially reranked, or returned from retrieval fallback. Treat absence as reranked for responses from older servers during rolling deployment. Inspect each match.ranking_source before presenting its score as an AI fit score.

Option 1

Option 2

Option 3

Show child attributes