Skip to main content

PeopleSearchAccountResponse

okbooleanrequired
statusPeopleSearchAccountStatus (string)required

exact — the handle was found; renamed — the account was found under a newer handle (resolved_handle); loaded — the account was not known yet and its profile was read from the network on demand (instagram, facebook, twitter); unknown — nobody has it; error — the lookup failed (error_code).

Possible values: [exact, renamed, loaded, unknown, error]

sourceSource (string)required

source social network of profile

Possible values: [ig, fb, tt, tw, li]

Default value: tw
handlestringrequired
resolved_handlestring
card object

The account, when it was found — the next round sends it in picked.

imagestringrequired
idProfileId (string)required

id of profile

usernamestringrequired
fullnamestringrequired
imageNotLoadedboolean
sourceSource (string)required

source social network of profile

Possible values: [ig, fb, tt, tw, li]

Default value: tw
linkstringrequired
badReasonProfileBadReason (string)

followsPrivate means TikTok has hidden its following list; it does not imply that the account itself is private.

Possible values: [unloaded, unmapped, zeroFollows, private, notFound, optOut, unexpected, followsPrivate]

badReasonConfirmedboolean
pinnedbooleanrequired

Pinned to the top by an exact lookup (@handle, phone) or the identity graph.

Default value: false
pickedbooleanrequired

The account the user picked in this network.

Default value: false
pin_rankintegernullable

Order among the pinned cards (unique within a panel).

panel_rankintegernullable

Where the core's ranking had this card (null when it came from a lookup, not from retrieval).

matchedstring[]required

Which fields of the query this card matched — NAMES ONLY, never values: name, place, bio, work, interests, gender, age, language, friends (the place or the interests of the people they follow — not their own), phone, handle. This is the whole of what a card may say about why it is here; the client renders each name from its own closed dictionary and drops a name it does not know. A masked (phone-lookup) card carries an empty array.

confidencestring

How sure the identity graph is that this account belongs to the same person, when it is the graph that put the card in this panel: one of CONFIRMED, SURE, STRONG — the graph's own bands, the only three that make an account a pin. Absent on every other card. It is a BAND, never a number: it is not a threshold on a probability and must not be rendered as one, and no percent is computed anywhere. WHY the graph is sure — which pick, on what evidence, how crowded the decision was — is not sent.

seed_originboolean

The account this seeded search started from ("find other their accounts").

linked_to object

A phone mask search's PERSON: on a card of another network's panel, the Instagram account of the same person — a card of this report's Instagram panel, by the report's own id. One person is that Instagram card plus every card whose linked_to names it; the client draws them as one row and ticks them together. Only the identity graph's certain partners get one (the pins' rule), at most one per network per person. An exception (with lifted_by) to "no pointer to where a card came from" above: it says WHOSE account this is, never why or how sure. Absent on every other card.

sourceSource (string)required

source social network of profile

Possible values: [ig, fb, tt, tw, li]

Default value: tw
idProfileId (string)required

id of profile

lifted_by object

The card was LIFTED by a LinkedIn hit (PeopleSearchLiftedBy) — like linked_to, an exception to "no pointer to where a card came from": it names the network and the typed facts, never the LinkedIn profile, why or how sure. Kept with the stored panels, so a restore shows it again. Absent on every other card, a pinned card included (a pin is never re-marked as lifted).

sourceSource (string)required

The network of the hit that lifted the card — li.

Possible values: [ig, fb, tt, tw, li]

Default value: tw
signalsstring[]required

The typed facts the LinkedIn hit matched — names from matched's closed vocabulary: work, place. The client drops a name it does not know.

error_codestring
took_msinteger
PeopleSearchAccountResponse
{
"ok": true,
"status": "exact",
"source": "tw",
"handle": "string",
"resolved_handle": "string",
"card": {
"image": "string",
"id": "string",
"username": "string",
"fullname": "string",
"imageNotLoaded": true,
"source": "tw",
"link": "string",
"badReason": "unloaded",
"badReasonConfirmed": true,
"pinned": false,
"picked": false,
"pin_rank": 0,
"panel_rank": 0,
"matched": [
"string"
],
"confidence": "string",
"seed_origin": true,
"linked_to": {
"source": "tw",
"id": "string"
},
"lifted_by": {
"source": "tw",
"signals": [
"string"
]
}
},
"error_code": "string",
"took_ms": 0
}