Filtering & Query Parameters

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

Pagination

Applies to: all list endpoints

All list endpoints support pagination:

Parameter	Type	Default	Max	Description
`page`	integer	1	-	Page number (minimum: 1)
`page_size`	integer	20	endpoint-specific	Results per page. Flow endpoints (`/v1/trends/mixed-flows`, `/v1/trends/flows`) cap at 25; odds endpoints cap at 100. See the API Reference for each endpoint's limit.

See Pagination for details on the response format.

Entity Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Filter by sport, league, team, or player using numeric IDs:

Parameter	Description
`sport_ids`	Filter by one or more sports (`sport_key` slug accepted as an alternative)
`league_ids`	Filter by one or more leagues
`team_ids`	Filter by one or more teams
`player_ids`	Filter by one or more players
`event_ids`	Filter by one or more specific events

The array fields accept one or more IDs; an empty array means no filter. Resolve IDs once via the reference endpoints and filter on IDs from there. When both sport_id and sport_key are provided, the ID takes precedence.

Flow Type Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

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`	Sub-type for fact flows (default: `base`)

{
  "sport_ids": [1],
  "league_ids": [7],
  "flow_type": "fact",
  "bet_type": "singles",
  "page": 1,
  "page_size": 10
}

Hit Rate & Probability Thresholds

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Filter flows by statistical thresholds:

Parameter	Type	Range	Description
`min_hit_rate_threshold`	integer	0–100	Minimum hit rate (percentage)
`max_hit_rate_threshold`	integer	0–100	Maximum hit rate (percentage)
`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	-	Only return fact flows whose trends have hit 100% of the time

{
  "sport_ids": [1],
  "min_hit_rate_threshold": 55,
  "max_hit_rate_threshold": 85,
  "page": 1,
  "page_size": 10
}

Split & Likelihood Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

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

Operator Filters

Applies to: /v1/trends/*, /v1/odds/*

Filter by sportsbook operators using numeric IDs or slug-style 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"]`)

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

Betting Market Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Parameter	Type	Description
`betting_market_ids`	array of integers	Filter by betting market IDs
`betting_market_category_ids`	array of integers	Filter by one or more betting market categories
`betting_market_position_ids`	array of integers	Filter by one or more betting market positions
`betting_market_entity_type`	string	`"player"`, `"team"`, or `"event"`

Tag Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Segment flows by content or metadata tags. Resolve tag type IDs from the tag registry first — see the Segmentation & Tags guide.

Parameter	Type	Description
`content_tag_type_ids`	array of integers	Filter by what the flow is about (narrative angle). OR mode by default.
`content_tag_require_all`	boolean	When `true`, a flow must match all content tags (AND).
`metadata_tag_type_ids`	array of integers	Filter by structural attributes (league, position, etc.). OR mode by default.
`metadata_tag_require_all`	boolean	When `true`, a flow must match all metadata tags (AND).
`include_star_sign_content`	boolean	Opt in to star-sign / horoscope-themed content (fact/plain parlay only).

{
  "flow_type": "fact",
  "bet_type": "parlay",
  "content_tag_type_ids": [15, 42],
  "content_tag_require_all": false,
  "metadata_tag_type_ids": [201, 205],
  "metadata_tag_require_all": true,
  "page": 1,
  "page_size": 20
}

Date Filters

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

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_ids": [1],
  "event_start_date_from": "2026-03-26",
  "event_start_date_to": "2026-03-28",
  "page": 1,
  "page_size": 10
}

Boolean Flags

Applies to: /v1/trends/* (some also /v1/betting/*)

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_basic_trends`	`false`	Omit fact flows with conditions
`starting_soon`	`false`	Only return flows for events starting within the next hour. For a custom window, use `event_start_date_from` / `event_start_date_to` instead
`full_hit_rate`	`false`	Only return fact flows whose trends have hit 100% of the time (a perfect historical hit rate)
`use_cartoon_images`	`false`	Replace logo fields with cartoon-jersey image URLs

Search

Applies to: /v1/references/*

Reference endpoints 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

Applies to: /v1/betting/*

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