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.
source social network of profile
Possible values: [ig, fb, tt, tw, li]
twid of profile
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.
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
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}$
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
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
quick — a first look at this part's networks (PeopleSearchStage); needs round_key.
Absent or full — the part itself.
Possible values: [quick, full]
full{
"source": "tw",
"id": "string",
"pick": true,
"sources": [
"tw"
],
"round_key": "string",
"round_sources": [
"tw"
],
"from_report": "string",
"stage": "full"
}