Orbit

Get creator outliers for a keyword search

Retrieves creators who significantly outperform their follower count.

get/v1/orbit/{orbit_id}/creators/outliers

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/orbit/{orbit_id}/creators/outliers
Auth: HTTP bearer

Path parameters

orbit_idstring required

Orbit search ID (UUID) returned when the search was created.

Query parameters

limitnumber

Example:50

Maximum number of items to return. Values above 100 are clamped to 100 rather than rejected.

pagenumber

Example:1

Page number for pagination

order_by'outlier_ratio' | 'avg_views' | 'follower_count' | 'weighted_score'

Example:outlier_ratio

Field to sort by

sort'asc' | 'desc'

Example:desc

Sort direction

platform'youtube' | 'tiktok' | 'instagram'

Filter by platform

Response

Successfully retrieved creator outliers

Example response

{
  "data": {
    "orbit_id": "550e8400-e29b-41d4-a716-446655440000",
    "total": 15,
    "limit": 50,
    "outliers": [
      {
        "author_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
        "creator_url": "https://www.tiktok.com/@creator",
        "creator_avatar_url": "https://storage.example.com/avatars/abc.jpg",
        "follower_count": 50000,
        "avg_views": 250000,
        "outlier_ratio": 5,
        "weighted_score": 26.9,
        "videos_analyzed": 20,
        "creator_topics": [
          "fitness",
          "health"
        ],
        "matching_topics": [
          "fitness"
        ],
        "platform": "tiktok",
        "identified_at": "2026-01-20T15:00:00.000Z",
        "median_views": 180000,
        "top_video_views": 990000,
        "breakout_video_count": 7,
        "avg_engagement_rate": 0.0842,
        "posts_per_week": 4.5,
        "content_angle": "Turns dry insurance topics into fast, myth-busting explainers with a strong first-line hook.",
        "growth_followers": 1200,
        "growth_views": 450000,
        "growth_video_count": 4,
        "local_video_count": 12,
        "videos": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "title": "How I grew to 100k followers",
            "description": "Full description of the video",
            "views": 250000,
            "likes": 12000,
            "comments": 340,
            "publish_date": "2026-01-15T10:30:00.000Z",
            "publishDate": "2026-01-15T10:30:00.000Z",
            "url": "https://www.tiktok.com/@user/video/123",
            "hashtags": [
              "fyp",
              "viral"
            ],
            "thumbnail_url": "https://storage.example.com/thumbnails/abc.jpg",
            "type": "tiktok"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.