Skip to main content

PeopleSearchHandleLookupResponse

handlestringrequired
took_msinteger
by_source objectrequired
property name* PeopleSearchHandleLookupResult
okbooleanrequired
statusPeopleSearchHandleLookupStatus (string)required

Possible values: [exact, renamed, id_only, fuzzy, unknown, error]

idProfileId (string)

id of profile

card object

A result card of the chat search. The identity keys are SearchProfile (the same shape the classic search returns — nickname, full name, avatar, link). The search core's raw profile data is NOT exposed, and neither is the reasoning: the card carries only WHICH fields of the query matched (matched, names without values), how sure the identity graph is when it is the graph that put the card here (confidence, one band word), and whether the card is pinned / picked / the seed origin. WHY the graph tied this account to another one is never sent — there is no why, no probability, no evidence family and no pointer to the pick it came from, on any card.

badReason / badReasonConfirmed (SearchProfile's) say whether a report can be built from the account, as on the classic cards — computed by the platform from its own state (the account's built profile and what its loaders saw), never from the search core. Absent — a report can be built now. unloaded — not yet: instagram / facebook / twitter load its follows when the report is confirmed; tiktok can do so only when User.ttFollowsEnabled is true (absent means false). private / zeroFollows / unmapped / notFound / followsPrivate — what a loader saw. followsPrivate means a hidden TikTok following list, not account privacy. optOut — the account opted out. badReasonConfirmed: true — a loader has already seen it. A card with optOut or badReasonConfirmed cannot be picked. A tiktok card with any reason also cannot be picked when User.ttFollowsEnabled is false or absent (the classic wizard's rule). A phone lookup's masked card keeps both keys (they do not name the account).

A LinkedIn card (source: li, the LinkedIn panel — User.peopleSearchLinkedinPanel) is a profile of our LinkedIn database, the card rule of PeopleSearchLinkedinOrigin: username is the slug, fullname the name our database holds, link https://www.linkedin.com/in/<slug>; no biography or headline is ever sent, and matched says work when the typed work matched its profession. It can be picked but is never a report subject, so badReason does not apply to it.

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.

candidates object[]
  • Array [
  • 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.

  • ]
  • resolved_handlestring
    basicbooleanrequired
    error_codestring
    PeopleSearchHandleLookupResponse
    {
    "handle": "string",
    "took_ms": 0,
    "by_source": {}
    }