vlayervlayer docs
Data lookups

Profile interpretation

Interests, persona, brand affinities and audience size for a public profile, each with the evidence behind it.

Send a handle and get back a structured read of who this person is, ready to use at onboarding: personalize the first screen, segment the user, or route them to the right programme.

Input: platform and handle. One handle is one platform.

What you get

FieldWhat it holds
summaryTwo or three sentences on who they are
interestsTopics, ranked by how strongly they show up
personaCreator, brand or everyday user, and their niche
brandAffinitiesBrands and accounts they follow or mention
audienceTierSize bucket from follower count, for example nano, micro, mid or macro
activityHow often they post and how recently
languages, locationOnly when the profile or posts state them
evidenceFor each interest and affinity, the posts or followed accounts it came from

Every interest and affinity comes with its evidence, so you can see why it is there.

An example output for a made-up Instagram creator:

{
  "platform": "instagram",
  "handle": "creator_jane",
  "summary": "Trail runner and home barista who posts race recaps and gear reviews.",
  "interests": [
    { "topic": "trail running", "strength": 0.92 },
    { "topic": "specialty coffee", "strength": 0.61 }
  ],
  "persona": { "type": "creator", "niche": "outdoor fitness" },
  "brandAffinities": ["Salomon", "Blue Bottle Coffee"],
  "audienceTier": "micro",
  "activity": { "postsPerWeek": 3, "lastPostedDaysAgo": 1 },
  "languages": ["en"],
  "location": "Denver, US",
  "evidence": [
    { "claim": "trail running", "source": "caption", "excerpt": "Long run before sunrise" },
    { "claim": "Blue Bottle Coffee", "source": "caption", "excerpt": "Morning pour-over" }
  ]
}

What it reads

PlatformReadsFollowing
InstagramBio, business category, post captionsNo
TikTokBio, video captionsOne page of followed accounts, with their bios
YouTubeChannel description, video titles and descriptionsNo
XBio, one page of the latest postsOne page of followed accounts, with their bios

Only TikTok and X list the accounts a profile follows. Further pages are a Following lookup.

Last updated on