Filtering & Query Parameters

Most Betflow B2B API endpoints accept filtering parameters to narrow down results. This guide covers the common parameters available across the API.

Pagination

All list endpoints support pagination:

Parameter	Type	Default	Max	Description
page	integer	1	—	Page number (minimum: 1)
page_size	integer	20	100	Results per page

See Pagination for details on the response format.

Entity Filters

Filter trends and flows by sport, league, team, or player. You can use either numeric IDs or external keys:

Parameter	Alternative	Description
sport_id	sport_key	Filter by sport
league_id	league_key	Filter by league
team_id	team_key	Filter by team
player_id	player_key	Filter by player
event_id	—	Filter by specific event
entity_type	—	"player" or "team"

When both an ID and a key are provided for the same entity, the ID takes precedence.

Flow Type Filters

Control which types of flows are returned:

Parameter	Values	Description
flow_type	fact, fun, plain	Type of flow. plain only returns parlays
bet_type	singles, parlay, same_game_parlay	Filter by bet structure
fact_flow_type	base, expanded, multi	Sub-type for fact flows (default: base)

{
  "sport_id": 1,
  "league_id": 7,
  "flow_type": "fact",
  "bet_type": "singles",
  "page": 1,
  "page_size": 10
}

Hit Rate & Probability Thresholds

Filter flows by statistical thresholds:

Parameter	Type	Range	Description
min_hit_rate_threshold	number	0.0–1.0	Minimum hit rate
max_hit_rate_threshold	number	0.0–1.0	Maximum hit rate
min_implied_probability_threshold	number	0.0–1.0	Minimum implied probability
max_implied_probability_threshold	number	0.0–1.0	Maximum implied probability
full_hit_rate	boolean	—	Include full hit rate data in response

{
  "sport_id": 1,
  "min_hit_rate_threshold": 0.55,
  "max_hit_rate_threshold": 0.85,
  "page": 1,
  "page_size": 10
}

Split & Likelihood Filters

Parameter	Values	Description
split_type	overs, unders	Filter by over/under
likelihood_type	likely, possible, longshot	Filter by likelihood category

Operator Filters

Filter by sportsbook operators using IDs or external keys:

Parameter	Type	Description
operator_ids	array of integers	Include only these operators
operator_keys	array of strings	Include only these operators (e.g. ["draftkings", "fanduel"])
excluded_operator_ids	array of integers	Exclude these operators
excluded_operator_keys	array of strings	Exclude these operators

When both operator_ids and operator_keys are provided, the resolved IDs are merged together.

Betting Market Filters

Parameter	Type	Description
betting_market_ids	array of integers	Filter by betting market IDs
betting_market_category_id	integer	Filter by betting market category
betting_market_entity_type	string	"player", "team", or "event"

Date Filters

Parameter	Type	Description
event_start_date_from	string (ISO date)	Events starting on or after this date
event_start_date_to	string (ISO date)	Events starting on or before this date

{
  "sport_id": 1,
  "event_start_date_from": "2026-03-26",
  "event_start_date_to": "2026-03-28",
  "page": 1,
  "page_size": 10
}

Boolean Flags

Parameter	Default	Description
include_deeplinks	false	Return operator-specific deeplink URLs. Requires exactly one operator ID.
include_alt_lines	true	Include alternative lines
include_only_womens_sports	false	Only return women's sports flows
include_only_basic_trends	false	Omit fact flows with conditions
starting_soon	false	Only return flows for events starting soon
full_hit_rate	false	Include full hit rate breakdown

Search

Reference endpoints (/v1/references/*) support text search:

Parameter	Type	Description
search	string	Search by name (partial match)

curl "https://api.odditt.com/v1/references/teams?search=patriots&page=1&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Country & Region Filters

Used primarily in betting and deals endpoints:

Parameter	Default	Description
country_code	"US"	ISO 3166-1 alpha-2 country code
country_iso_code	—	ISO country code (affiliate offers)
subnational_region_code	—	ISO 3166-2 state/province code