Replay a saved search

Replay a stored PEOPLE saved search. Equivalent to POST /prospects/search with savedSearchId; both echo the resolved filters, and this one always includes ignoredFilterKeys because the source is always a stored search.

The optional body carries only the caller’s half of the search — size, scrollToken, linkedinUrl — or may be omitted entirely. The stored filters ARE the search: any other key, filters included, is rejected with 422 VALIDATION_FAILED naming it rather than silently ignored. That body is validated on its own before the stored search is loaded, so a bad size is reported as your error; SAVED_SEARCH_INVALID means the STORED filters no longer run.

A company saved search cannot be replayed here — it answers 422 SAVED_SEARCH_TYPE_MISMATCH; run it with POST /companies/search and savedSearchId instead.

Filters the search no longer serves are dropped from the stored search and listed in ignoredFilterKeys.

Rows and paging behave exactly as in POST /prospects/search: rows keyed by linkedin_url, with the LinkedIn member id as linkedinMemberId and no pdlId, plus savedProfile / savedBy and the LinkedIn relation ids, a nullable scrollToken, and total, an estimate or null. No row carries an email address or a phone number, enrichment history included. Billing: 1 credit per requested profile pre-checked, 1 credit per profile returned debited. (Enforced by the public row transformer, which removes Fuse’s enrichment overlay before the row is returned.)

Errors:

• 402 INSUFFICIENT_CREDITS — The balance does not cover 1 credit per requested profile; nothing was billed.
• 404 SAVED_SEARCH_NOT_FOUND — No saved search of yours has that id.
• 422 VALIDATION_FAILED — The request failed the declared schema; param names the offending key and message quotes the rule it broke.
• 422 SAVED_SEARCH_TYPE_MISMATCH — The saved search stores COMPANY filters, which this endpoint cannot run; param is savedSearchId. Run it with POST /companies/search and savedSearchId instead.
• 422 SAVED_SEARCH_INVALID — The STORED filters no longer form a runnable search — every value was retired, or the blob translates to nothing. Never used for anything the caller sent.
• 422 SEARCH_FILTERS_INVALID — The provider rejected the assembled query as malformed. Also a vocabulary filter holding only values the search cannot serve; then param names the filter and values lists them.
• 422 FILTER_VALUE_UNRESOLVED — No company, place or LinkedIn profile named in one filter could be found, or no value of an email or phone filter is an email address or a phone number, so the search was refused instead of run without it; param names the filter (or linkedinUrl) and values lists the values nothing matched. Take company, place and profile values from GET /prospects/autocomplete.
• 422 SCROLL_TOKEN_INVALID — scrollToken is not one this API issued (a token from an earlier version of the search included), so the search cannot continue from it; nothing was billed. Start again without scrollToken.
• 422 COMPANY_EXCLUDES_UNRESOLVED — Excluded company names could not be identified (past the 500 per filter a search looks up beyond our own company records, out of time, or the lookup failed), so the search was refused rather than return the people they exclude; param names the first such filter. Nothing was billed. Retry, exclude companies by the identity GET /prospects/autocomplete returns, or exclude fewer by name.
• 422 SEARCH_CHANGED — The filters no longer build the search the scrollToken came from (they, or the companies they name, changed since its first page), so it cannot continue; nothing was billed. Start again without scrollToken.
• 429 RATE_LIMITED — Per-token rate limit for this bucket exhausted; retry after the window in the RateLimit-Reset header.
• 500 UNEXPECTED_ERROR — The request failed inside the service; nothing was billed and the request_id identifies the failure.
• 503 UNEXPECTED_ERROR — Looking up the company names, email addresses or phone numbers in the filters took longer than the request allows; nothing was billed. Send the same request again: the lookups that finished are kept, so the retry gets further.
• 504 UNEXPECTED_ERROR — The search provider took too long and the search was stopped; nothing was billed. Narrow it (a job title or location, or fewer company_filters) and search again.

Requires one of the following token scopes: search.