Skip to main content
Save the people or companies you already know, such as customers or a do-not-contact list, then pass the list to a search. Sixtyfour searches first and removes the listed records before it returns results.

Create a list

Send entity_type, a name and one source in from.
The list builds in the background:
HTTP 202

Sources

from takes exactly one of these: A people list accepts LinkedIn public IDs and LinkedIn profile URLs. A companies list accepts numeric LinkedIn company IDs, LinkedIn company URLs or slugs, and exact website domains. A company value that matches no company, or more than one, is skipped and counted in unresolved_count. A Search Job must match the list: a people search builds a people list, a company search a companies list. Any other pairing returns entity_type_mismatch.

Files

Sixtyfour reads the first column it recognizes. Column names match without regard to case, spaces or punctuation, so public_id, publicId and Public ID are the same column. A file with a single unrecognized column is read as a list without a header. Values are deduplicated, and a CSV must be UTF-8.

Wait until the list is ready

Read the list until status is ready. Wait a few seconds between requests. Replace LIST_ID with the list_id from the create response.
HTTP 200

Search without the listed records

Pass the list in exclude_list_ids on POST /v1/people/search or POST /v1/companies/search.
The search returns a Job, as every search does. A people list works only in a people search and a companies list only in a company search. The other pairing returns entity_type_mismatch. /v1 searches exclude by saved list only. To leave out a few records, save them as a small list first.

Manage lists

Lists do not change after they are built. To change one, create a new list and delete the old one. A search that names a deleted list returns not_found.

Limits

Every list that is not deleted counts toward the active-list limit, including building and failed lists. To request extended exclusion limits, contact support@sixtyfour.ai.

Original routes

/search/exclusion-lists and inline exclude_entity_ids on the original search routes keep working. See Search Exclusions (Legacy).

Errors

For error responses (400, 403, etc.), see Handling Errors.