OverviewAPI Reference
People

List people

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.

GET
/v1/people

Authorization

AuthorizationBearer <token>

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

In: header

Query Parameters

platform?string

People with an account on this platform.

Value in"bluesky" | "hackernews" | "github" | "stackoverflow" | "devto" | "reddit" | "x" | "youtube" | "news" | "linkedin"
q?string

Matches the display name or the profile handle or URL, case-insensitively.

Length1 <= length <= 200
tag?string

Only people carrying this tag (exact, case-sensitive).

Length1 <= length <= 40
muted?boolean

true: only muted people; false: only unmuted; omitted: everyone.

since?string

Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).

Formatdate-time
segmentId?string

A saved segment applied on top of every other filter here. Unknown id: 404.

Length1 <= length
platforms?array<string>

People with an account on any of these platforms. Repeatable, or comma-separated.

Itemsitems <= 20
tags?|null

People carrying any of these tags. Repeatable, or comma-separated.

Itemsitems <= 20
minFollowers?integer|null

At least this many followers. Unknown reach never matches.

Range0 <= value
maxFollowers?integer|null

At most this many followers.

Range0 <= value
minMentions?integer

At least this many matched mentions.

Range1 <= value
minNegative?integer

At least this many negative mentions.

Range1 <= value
intents?|null

At least one mention carrying any of these intents.

Itemsitems <= 10
notPlatforms?array<string>

Nobody with an account on these platforms. Repeatable, or comma-separated.

Itemsitems <= 20
notTags?|null

Nobody carrying any of these tags. Repeatable, or comma-separated.

Itemsitems <= 20
notIntents?|null

Nobody whose mentions carry any of these intents. Repeatable, or comma-separated.

Itemsitems <= 10
keywordKinds?array<string>

Mentioned a keyword of any of these kinds.

Itemsitems <= 3
neverKeywordKinds?array<string>

Never mentioned a keyword of these kinds.

Itemsitems <= 3
newSinceDays?integer

First seen within this many days.

Range1 <= value <= 365
linkHosts?|null

People with at least one mention linking to any of these hosts, the host itself or a subdomain of it. Repeatable, or comma-separated.

Itemsitems <= 20
stages?array<string>

People at any of these outreach stages. Repeatable, or comma-separated.

Itemsitems <= 6
automated?boolean

true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest; omitted: everyone.

ownerIds?|null

People owned by any of these members (user ids); none matches people nobody owns. Repeatable, or comma-separated.

Itemsitems <= 20
sort?string

mentions: most matches first. recent: last seen first. reach: most followers first, unknown last. new: first seen most recently first.

Default"mentions"
Value in"mentions" | "recent" | "reach" | "new"
limit?integer

Page size, 1 to 100.

Default50
Range1 <= value <= 100
offset?integer|null

Skip this many people. Offset paging: a grouped read over hundreds of people, not a stream.

Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

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

Get a person GET

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

List outreach activities GET

Every logged contact with this person across all their accounts, newest first (at most 200): who reached out, the channel, when, and a short note. Read it before reaching out so two teammates never contact the same person without knowing.