---
title: "Get a single post for a tracked creator"
method: GET
path: "/v1/tracking/creators/{id}/posts/{post_id}"
tags: ["Tracking"]
---

# Get a single post for a tracked creator

`GET /v1/tracking/creators/{id}/posts/{post_id}`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/tracking/creators/{id}/posts/{post_id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required
- `post_id` string, required

## Response `200`

Creator post

- CreatorPostResponseDto
  - `data` CreatorPostDataDto, required
    - `id` string, required
    - `tracking_account_id` string, required
    - `platform` 'tiktok' | 'youtube' | 'instagram', required
    - `platform_video_id` string, required
    - `url` string, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `thumbnail_url` string, nullable: Post thumbnail URL. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
    - `publish_date` string, nullable
    - `views` number, nullable
    - `likes` number, nullable
    - `comments` number, nullable
    - `shares` number, nullable
    - `bookmarks` number, nullable
    - `is_duet` boolean, required: Whether this post is a TikTok duet. Always false for YouTube/Instagram.
    - `is_stitch` boolean, required: Whether this post is a TikTok stitch. Always false for YouTube/Instagram.
    - `duration_seconds` number, nullable
    - `hashtags` string[]
    - `collected_at` string, required
    - `is_outlier` boolean, nullable: True when this post is a statistical view-count outlier for the creator (≥3× the creator's median). Computed each collection cycle.
    - `outlier_ratio` number, nullable: How many times the creator's median views this post got (e.g. 4.2 = 4.2× median). Null when not an outlier or median is unknown.
    - `outlier_weighted_score` number, nullable: Recency-weighted outlier score used to rank breakout posts. Null when not an outlier.
    - `sound` V1SoundDto
      - `id` string, required: Virlo's internal sound ID (UUID). Use this for the /v1/sounds/:sound_id family (details, videos, usage-history, resolve). For the satellite sound lookup prefer `external_id`, though passing this UUID also works — it is auto-resolved to the sound's platform + external_id.
      - `external_id` string, nullable: Platform-native sound identifier (TikTok music/clip id, or Instagram audio id). This is the `music_id` accepted by the satellite sound lookup — call GET /v1/satellite/sounds/{platform}/{external_id} for TikTok or Instagram sounds. YouTube sounds are not supported (you'll get a 400). Null for sounds without a platform id.
      - `title` string, required
      - `platform` 'tiktok' | 'youtube' | 'instagram', required
      - `duration` number, nullable: Duration in seconds. Available on TikTok only.
      - `cover_url` string, nullable: Sound cover image URL. Available on TikTok and YouTube. Always an absolute URL (or null). Images Virlo stores are served from https://auth.virlo.ai/storage/v1/object/public/<bucket>/; platform CDN links are passed through. Some files are HEIC, which most non-Safari browsers cannot render, so convert before display if you need to.
      - `owner_handle` string, nullable: Sound owner handle. Partially available on TikTok (~12%).
      - `owner_nickname` string, nullable: Sound owner display name. Available on TikTok, YouTube, Instagram.
      - `is_original` boolean, nullable: Whether the sound is an original creation. TikTok only.
      - `is_commerce_music` boolean, nullable: Whether the sound is cleared for commercial use. TikTok only.
      - `usage_count` number, nullable: Platform-wide usage count. TikTok only.

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Post not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)