vlayer Docs

List all creators

Lists all users with linked social accounts, including campaign stats (attempts, verified, rewarded, points).

Authorization

AuthorizationRequiredBearer <token>

API token. Send it as Authorization: Bearer <API_TOKEN>.

In: header

curl -X GET "//admin/creators" \
  -H "Authorization: Bearer <token>"

Creator list

{
  "data": [
    {
      "userId": 42,
      "email": "jane@example.com",
      "displayName": "string",
      "avatarUrl": "string",
      "platform": "instagram",
      "platformUsername": "creator_jane",
      "connectedAt": "2019-08-24T14:15:22Z",
      "profileData": {
        "profile_pic_url": "https://...",
        "full_name": "Jane Creator",
        "biography": "Content creator",
        "is_verified": true,
        "followers": 15400,
        "following": 312
      },
      "totalAttempts": 5,
      "totalVerified": 4,
      "totalRewarded": 3,
      "totalPoints": 300
    }
  ]
}

Refresh creator profile

Fetches latest profile data (Instagram or TikTok) and updates the stored profile.

If the scraping provider cannot read the profile, the reason is propagated — see the ScrapingError schema.

Authorization

AuthorizationRequiredBearer <token>

API token. Send it as Authorization: Bearer <API_TOKEN>.

In: header

Path Parameters

userIdRequiredinteger

curl -X POST "//admin/creators/{userId}/refresh" \
  -H "Authorization: Bearer <token>"

Updated profile data

{
  "data": {}
}

Verify Instagram handle

Check if an Instagram handle has a verified (connected) social account in the system.

Authorization

AuthorizationRequiredBearer <token>

API token. Send it as Authorization: Bearer <API_TOKEN>.

In: header

Path Parameters

handleRequiredstring

curl -X GET "//admin/creators/verify/creator_jane" \
  -H "Authorization: Bearer <token>"

Verification result

{
  "data": {
    "verified": true
  }
}

Creators

Response

TypeScript

Response

TypeScript

Response

TypeScript