Filters
The API supports advanced filtering to help you retrieve only the story content you need.
This endpoint accepts a range of query parameters that let you refine results by title, status, geographic targeting, creation and update timestamps, and associations with specific games, teams, players, and other entities.
Query parameters
| Query parameter | Type | Description |
|---|---|---|
| Title | string | Filter stories by title (case-insensitive substring match) |
| LabelsFilterExpression | string | Filter stories using a label expression (see Label Expressions section below) |
| Statuses | array of ContentStatus | Filter stories by their current status |
| Geo | string | Filter stories by geographic region |
| OnlyLive | boolean | When set to true, returns only currently live stories |
| UpdateTime.From | string (datetime) | Filter stories updated after the specified date/time |
| UpdateTime.To | string (datetime) | Filter stories updated before the specified date/time |
| CreateTime.From | string (datetime) | Filter stories created after the specified date/time |
| CreateTime.To | string (datetime) | Filter stories created before the specified date/time |
Entity filters
Stories can be filtered by their relation to various sports-related entities. You can filter using the WSC ID or the service provider ID.
| Query parameter | Context (entity) | Parameter type | ID source |
|---|---|---|---|
| Entities.Game.WscId | Game | integer | WSC |
| Entities.Game.ServiceProviderId | Game | string | Service provider |
| Entities.Team.WscId | Team | integer | WSC |
| Entities.Team.ServiceProviderId | Team | string | Service provider |
| Entities.Player.WscId | Player | integer | WSC |
| Entities.Player.ServiceProviderId | Player | string | Service provider |
| Entities.Round.WscId | Round | integer | WSC |
| Entities.Round.ServiceProviderId | Round | string | Service provider |
| Entities.Season.WscId | Season | integer | WSC |
| Entities.Season.ServiceProviderId | Season | string | Service provider |
| Entities.IdType | — | EntityIdType | Selection logic |
Label expression filtering
The LabelsFilterExpression parameter allows you to filter stories using a boolean expression based on labels.
Syntax
The expression is formatted as a JSON array with the following structure:
- [operator, condition1, condition2, ...]
- Operators can be "and" or "or"
- Conditions can be either strings in "label:value" format or nested arrays with the same structure
- Nested arrays allow for complex filtering logic
Examples
- Simple conditions with AND: ["and", "football", "recap"]
- Multiple conditions with OR: ["or", "football", "basketball", "hockey"]
- Nested conditions: ["and", ["or", "football", "basketball"], "highlight"]
- Complex nesting: ["or", ["and", "football", "recap"], ["and", "basketball", "highlight"]]
Date format
All date parameters should be in ISO 8601 format
YYYY-MM-DDThh:mm:ssZExample requests
Get all football stories created in the last 24 hours
GET /v1/stories?LabelsFilterExpression=sport:football&CreateTime.From=2025-03-31T00:00:00ZGet all live stories featuring a specific player
GET /v1/stories?OnlyLive=true&Entities.Player.WscId=12345Get all stories for a specific team
GET /v1/stories?Entities.Team.WscId=678Schema definitions
ContentStatus
Enum representing the possible statuses of a story:
draftactive
EntityIdType
Enum representing the id provider WSC ID and Service Provider ID are provided:
wsc- Use WSC IDservice_provider- Use Service Provider ID
Updated 1 day ago