Skip to main content

PeopleSearchSeedRequest

"Find other their accounts": start a fresh search of this report from what one result card knows. The server reads the card by id from the search service and seeds the fields itself (name, place, interests, gender, language — never the handle, the bio or the phone); the card's raw data never reaches the client. The seeded fields come back in search_state.fields, editable like any other query.

sourceSource (string)required

source social network of profile

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

Default value: tw
idProfileId (string)required

id of profile

pickboolean

The card is also the user's PICK on its network (an @handle lookup: "this is them, now find the rest"): the seeded round keeps it in search_state.picked, so the other networks are searched by what the card knows AND pinned by the identity graph.

sourcesSource (string)[]

Networks to search in THIS request; default — every searchable network (li only where User.peopleSearchLinkedinPanel is true, as in PeopleSearchRequest.sources). With round_key: this part's networks (the platform's client sends one), each of them one of round_sources.

Possible values: [ig, fb, tt, tw, li], <= 5

round_keyPeopleSearchRoundKey (string)

The key of a round sent in PARTS — one request per network, in parallel, each answered as soon as its network is searched. The client mints one key per round (a UUID) and sends it with every part. Every part of one key is ONE round: the refinement cap and the rate limit count it once; it has one search_state and one set of stored panels. The first part of a key to reach the server fixes the round's query (fields, picks, questions asked, interests, typed line, seed origin; for /seed the card); a later part of the same key searches THAT query for its own networks, whatever its own body says. The round becomes the report's search (its search_state, the stored panels, the history row, a phone lookup's paywall) when the first of its networks answers. A round none of whose networks answered is given back exactly like a single round the search service failed: not counted, the report's previous search kept. A part of a round that has ended (all its networks answered, a newer round replaced it, it failed, or its time to resume — twice the search timeout — has passed) changes nothing and is answered superseded: true. LATE FILL (the lazy full wave): once a round is the report's search (one of its networks answered), a part for one of its networks that has not answered yet is admitted for longer — while the round is still the report's current one and within a limited time of its start (30 minutes). So a client may send a network's full part only when that network's tab is opened, or in the background while the search service has spare capacity (es_spare): it joins the round like any other part — no count, the round's fixed query. GET /people-search/state offers those networks as pending for as long.

Possible values: >= 8 characters and <= 64 characters, Value must match regular expression ^[A-Za-z0-9_-]{8,64}$

round_sourcesSource (string)[]

With round_key: every network of the round — all its parts together; default — every searchable network. Read from the part that opens the round only.

Possible values: [ig, fb, tt, tw, li], <= 5

from_reportReportId (string)

The search the card was shown in, when the seeded search is a NEW one: a card's "find other their accounts" opens a search of its own (a new report, created by POST /create), so the one it was on is left as it is. The card is then checked against that report — the caller's own, not a phone lookup — instead of this one; a card it has not shown is 404, as without it. Absent: the card must be one this report has shown. Read from the part that opens the round only.

Possible values: >= 24 characters and <= 24 characters

stagePeopleSearchStage (string)

quick — a first look at this part's networks (PeopleSearchStage); needs round_key. Absent or full — the part itself.

Possible values: [quick, full]

Default value: full
PeopleSearchSeedRequest
{
"source": "tw",
"id": "string",
"pick": true,
"sources": [
"tw"
],
"round_key": "string",
"round_sources": [
"tw"
],
"from_report": "string",
"stage": "full"
}