OverviewAPI Reference
People

Get a person

One person as your workspace sees them. An account merged into someone resolves to that person.

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

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. 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.