Entity Search
Introduction
This guide focuses on how to utilize the Entity Search endpoint.
Entity Search is a powerful tool for discovering entities or records of interest. Whether you’re investigating specific individuals like Victoria Beckham or exploring entities related to a broader inquiry, this endpoint provides a robust search capability to pinpoint the information you need.
Basic Entity Search
To make a simple request, use the “q” parameter to search against a query. The following are equivalent:
Both GET and POST methods are supported. If you are a new API consumer, we recommend onboarding with POST, which will be referenced throughout this guide.
Warning: All search arguments passed through the query string of the GET request must be URL encoded. For example, foo OR (bar~5) becomes foo%20OR%20(bar~5).
To initiate a workflow, begin by searching for an entity. For instance, to search for Victoria Beckham, you would use the following command:
This command returns the top entity match for “Victoria Beckham”, showcasing important details about the search hit:
Key Fields Explained
Visit our ontology page to get a better understanding of our enum types and risk factors.
data
: An array of search hitsdata[].id
: Sayari’s unique ID for the entitydata[].label
: The entity’s namedata[].type
: The type of entity (e.g., person or company)data[].entity_url
: A relative URL to view more details about the entitydata[].identifiers
: A list of unique identifiers for the entitydata[].countries
: Associated countries for the entity using ISO 3166-1 alpha-3 codesdata[].source_count
: Counts of unique documents per source where this entity was founddata[].relationship_count
: Counts of neighbor entities by relationship typedata[].matches
: Highlighted matches in the search result
These fields help determine if a search hit warrants further investigation by providing insights into the entity’s relevance and connections.
Entity Search Facets
For a more granular view of your search results’ distribution by country, source, and entity type, include the facets
query parameter:
The response will now include a facets
property, offering a breakdown of counts per facet. This helps you understand the diversity and focus areas of your search results.
Entity Search Filters
To refine your search results, apply filters based on source, country, or entity type. This is particularly useful when dealing with common entity names or when you have specific criteria in mind:
Searching by Specific Fields
Beyond basic filters, you can target your search to specific fields, like identifier, address, name, position, and contact. For instance, to find entities matching a particular identifier:
Congratulations! This concludes our Entity Search Guide. The Entity Search endpoint is a versatile tool for your investigative workflows, enabling you to explore entities based on a wide range of criteria. By leveraging facets and filters, you can navigate through vast datasets to find exactly what you’re looking for, ensuring your investigations are both efficient and comprehensive.