Tracking

List posts for a tracked creator

get/v1/tracking/creators/{id}/posts

Request

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

Path parameters

idstring required

UUID of the tracked creator

Query parameters

pagenumber

Example:1

Page number, 1-indexed (default 1).

limitnumber

Example:50

Max posts per page (default 50, max 200)

start_datestring

Start date (ISO 8601). Filter posts published on or after this date.

end_datestring

End date (ISO 8601). Filter posts published on or before this date.

sort'publish_date_desc' | 'publish_date_asc' | 'views_desc'

Sort order (default: publish_date_desc)

Response

Creator posts

Example response

{
  "data": [
    {
      "sound": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "external_id": "7559312683885201425",
        "title": "Chopin Nocturne No. 2 Piano Mono",
        "platform": "tiktok",
        "duration": 246,
        "cover_url": "https://auth.virlo.ai/storage/v1/object/public/sound-covers/6e03a216-f8c8-40e9-ba9b-b79d8a287b57.jpg",
        "owner_handle": "@someone",
        "owner_nickname": "Someone",
        "usage_count": 5999231
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3,
    "has_next_page": true
  }
}

Changes

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