Skip to main content

​
Match Reasons

Every scored result includes human-readable reasons explaining why a creator was returned. These reasons help you validate results, build trustworthy UIs, and debug queries that aren’t landing.

​
Where Reasons Appear

EndpointFieldWhat it explains
POST /v1/searchdata[].match.reasonsWhy the creator matches your query
POST /v1/creators/lookalikedata[].similarity.shared_traitsWhy the creator is similar to the
POST /v1/creators/matchdata[].match.reasonsWhy the creator is a good, neutral, or poor fit for the campaign

​
Search Reasons

Search results include a score and a list of reasons: 
{
  "data": [
    {
      "creator": {
        "id": "a3f1b9c2-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
        "name": "Nadia Kaur"
      },
      "match": {
        "score": 0.92,
        "reasons": [
          "Creates educational fitness content focused on home workouts",
          "High engagement rate suggests an active audience",
          "Consistent posting cadence fits the query intent"
        ]
      }
    }
  ]
}
Reasons typically cover:
  • content relevance to the query
  • audience quality signals
  • posting consistency
  • niche depth and focus

​
Lookalike Reasons

Lookalike results explain shared traits between the seed creator and the match: 
{
  "data": [
    {
      "creator": {
        "id": "e8d7c6b5-a4f3-2e1d-0c9b-8a7f6e5d4c3b",
        "name": "Marcus Rivera"
      },
      "similarity": {
        "score": 0.87,
        "shared_traits": [
          "Both focus on fitness and wellness content",
          "Similar audience demographics",
          "Comparable engagement patterns on workout videos"
        ]
      }
    }
  ]
}
Typical themes: content overlap, audience similarity, style, and performance patterns.

​
Campaign Match Reasons

POST /v1/creators/match returns structured campaign-fit output with a and supporting reasons: 
{
  "data": [
    {
      "creator": {
        "id": "f9e8d7c6-b5a4-3f2e-1d0c-9b8a7f6e5d4c"
      },
      "match": {
        "score": 0.88,
        "decision": "good",
        "reasons": [
          {
            "text": "Strong fit — fitness content aligns with the protein bar category and audience skews health-conscious",
            "fact_id": "fact_123"
          }
        ]
      }
    }
  ]
}
DecisionMeaning
goodStrong fit for the campaign
neutralCould work — review manually
avoidWeak fit, likely not worth pursuing

​
How to Use Reasons

  • Surface them in your UI. Reasons make AI-driven results feel transparent. Showing “Strong sustainable fashion focus” next to a creator helps your users trust the ranking.
  • Validate your queries. If the reasons don’t match your intent, the query needs refining — tighten the language or add filters.
  • Compare across results. Reasons help you understand why one creator ranked higher than another, beyond just the numeric score.
  • Debug broad searches. When results feel off, the reasons usually reveal whether the query was too vague or the filters too loose.

​
Scores vs Reasons

Treat the score as the summary and the reasons as the explanation. A high score with reasons that don’t match your intent is a signal to refine the query, not to trust the number.