Search

Search allows users to filter and retrieve any of our available data fields based on custom search criteria.

Search Criteria

Criteria	Platform	API
League	NHL, MLB, NBA	league_id
Date and Time	6/2/2025 1:19:06 AM	snippet_filter.min_publish_date and snippet_filter.max_publish_date
Entity Type	Player, Team, Staff	entity_filters.operations array with entity_type_id and entity_id values
Entity Name	Michael Jordan	entity_filters.operations array with entity_type_id and entity_id values
News Types	Injury, Diagnosis, Recovery	news_filters.operations array with field and probability values
Game Status	All, Live, Pre-game	snippet_filter.in_play (true=Live, false=Pre-Post, null=All)
Original Report	All, Yes, No	snippet_filter.original_report (true=Original, false=Linked, null=All)
Search Term	"What's up with Lebron?"	snippet_filter.search_term
Snippet Distance	(0.0-1.0)	snippet_filter.snippet_distance (0.0-1.0, lower = more precise)

Note: league_id is required criteria for all searches.

Data Fields

Field	Example
league_id	3a296669-6a4b-4776-971e-fb117e993b8d
snippet_id	625479
snippet_text	We don't have official word on who will step into Tuesday's vacancy in the rotation against the Giants. But it seems significant that Matt Waldron's rehab assignment is over. He was optioned to Triple-A today. Stephen Kolek will start Monday in SF.
publish_date	6/2/2025 1:19
extracted_reporter	Kevin Acee
extracted_source	X
in_play	FALSE
parent_id	null
relevant	1
contract	0.00133
draft	0.00014
firing	0.00152
hiring	0.00704
injury	0.00073
lineup	0.99996
other	0.00014
performance	0.00007
practice	0.0022
recovery	0.71094
diagnosis	0.47742
suspension	0.00325
trade	0.00067
created_at	19:12.2
extracted_urls	[]

How to Search

Platform

1. In the Platform tab, click the Search Criteria button

2. This will open a window where you can select your criteria

3. Click Search to execute and view results

API

Below is an example response object. You can find more information on how to create searches using our API in the API Reference.

[Request Object]

Important Details

1. league_id is required for all searches

2. Searches can be saved for later reuse (see Manage Searches)

3. All searches can be converted to Live Alerts in the Platform

4. Search results include enriched metadata for each snippet

5. Semantic search capabilities allow for natural language queries