Get Started

Creators

API endpoint for retrieving workspace creators and their account information

GETPOSTPATCHDELETE
GET/creators

Headers

x-api-keystringrequired

Your Track My Posts API key

Query Parameters

workspaceSlugstringrequired

Workspace slug identifier

Example: my-workspace

querystring

Search query to filter creators by name

Example: john

sincestring

Start date filter (YYYY-MM-DD or ISO 8601 format)

Example: 2024-01-01

untilstring

End date filter (YYYY-MM-DD or ISO 8601 format)

Example: 2024-12-31

platformsarray

Filter by platforms (comma-separated or array)

Example: tiktokinstagram

slugsarray

Filter by creator slugs (comma-separated or array)

Example: 123456

pageinteger

Page number (1-indexed)

Example: 1

limitinteger

Number of items per page

Example: 20

sortBystring

Field to sort by

Example: name

sortOrderstring

Sort order

Example: desc

includeAllStatsboolean

Include all statistics in response

Responses

200Successful response with creators data
400Bad request - validation error
401Unauthorized - authentication required
403Forbidden - insufficient permissions
404Not found - workspace not found
500Internal server error
curl "https://api.trackmyposts.com/creators?workspaceSlug=my-workspace&query=john&since=2024-01-01&until=2024-12-31&platforms=tiktok%2Cinstagram&slugs=123%2C456&page=1&limit=20&sortBy=name&sortOrder=desc&includeAllStats=false" \
  -H "x-api-key: YOUR_API_KEY"
{
  "items": [
    {
      "id": "creator-123",
      "workspaceId": "workspace-123",
      "slug": 123,
      "name": "John Doe",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:00:00.000Z",
      "accounts": [],
      "accountsCount": 2,
      "followersTotal": 50000,
      "followingTotal": 1000,
      "postsCount": 100,
      "minGap": 3600,
      "likes": 10000,
      "comments": 500,
      "shares": 200,
      "saves": 300,
      "views": 500000,
      "topViews": 100000,
      "cost": 1000,
      "cpm": 2,
      "costSummary": null,
      "profitMin": 9000,
      "profitMax": 15000,
      "revenueMin": 10000,
      "revenueMax": 16000,
      "rpmMin": 20,
      "rpmMax": 32,
      "earliestPostedAt": "2024-01-01T00:00:00.000Z",
      "latestPostedAt": "2024-12-31T00:00:00.000Z",
      "lastPostedAt": "2024-12-31T00:00:00.000Z",
      "trackingStartedAt": "2024-01-01T00:00:00.000Z",
      "lastStatsAt": "2024-12-31T00:00:00.000Z",
      "engagementRate": 2.5,
      "owed": 0,
      "limitedData": false
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 50,
  "totalPages": 3,
  "hasNext": true,
  "hasPrev": false
}

Data Structures

View all 13 data structuresCreators

Explore all data structures used in this API endpoint