OverviewPlatformsAPI Reference
People

Get a person

One person as your workspace sees them. An account merged into someone resolves to that person. With `groupId`, the call works inside that keyword group: its people, and its own tags, notes, mute, merges and activities, apart from the workspace's and from every other group's.

GET
/v1/people/{id}

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Path Parameters

idstring

Person id (aut_...).

Length1 <= length

Query Parameters

groupId?string

Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/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"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Export people as CSV GET

The same list as GET /v1/people (segmentId included) as CSV, one row per person with their contact columns: handle, followers, email, website, company, location, tags, then outreach stage, owner and last contacted. Capped at 5,000 people. `groupId` scopes the export like the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.

List people GET

The people behind your mentions: one row per person, with their accounts, reach, public profile, per-workspace stats, your annotations and where your outreach stands. Filter by platform, tag, follower range, mention counts, intents seen, keyword kinds mentioned or never mentioned, outreach stage, owner, automated (bot accounts, whose matched posts are mostly machine-made), or a saved segment. Offset-paginated with a total. With `groupId`, only the people who mentioned that keyword group's keywords, counted over those mentions, with that group's own annotations, merges, outreach and segments.