OverviewPlatformsAPI Reference
People

Get a person

Fetches a person, with your workspace's own data on them. The id of a merged account returns the person it was merged into.

GET
/v1/people/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Path Parameters

id*string

The person's id (aut_...).

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/people/aut_abc123"
{  "id": "string",  "platform": "bluesky",  "name": "string",  "handle": "string",  "url": "string",  "avatarUrl": "string",  "accounts": [    {      "id": "string",      "platform": "bluesky",      "name": "string",      "handle": "string",      "url": "string"    }  ],  "reach": {    "followers": 0,    "following": 0,    "posts": 0  },  "profile": {    "bio": "string",    "company": "string",    "location": "string",    "website": "string",    "email": "string",    "links": [      {        "provider": "string",        "url": "http://example.com"      }    ],    "fetchedAt": "string"  },  "stats": {    "mentions": 0,    "relevant": 0,    "sentiment": {      "positive": 0,      "neutral": 0,      "negative": 0    },    "firstSeenAt": "string",    "lastSeenAt": "string"  },  "annotations": {    "tags": [      "string"    ],    "notes": "string",    "muted": true  },  "outreach": {    "owner": {      "id": "string",      "name": "string",      "email": "string"    },    "stage": "not_contacted",    "lastContactedAt": "string"  }}
Was this page helpful?

Export people as CSV

Returns as CSV the people GET /v1/people lists for the same filters, segmentId included. Each row is one person with handle, followers, email, website, company, location and tags, then outreach stage, owner and last contacted. The file holds at most 5,000 people. Each workspace can export 6 times a minute, and a 429 includes Retry-After.

List people

Returns the authors of your mentions, one row per person. Each row has their accounts, reach, public profile, stats for this workspace, your notes and tags, and your outreach status. You can filter by platform, tag, follower range, mention counts, intents, keyword kinds they did or did not mention, outreach stage, owner, automated (bots whose matched posts are mostly machine-made) or a saved segment. Pages use offset and include a total.