discover_by_provider
Find movies and TV shows available on specific streaming services in your region to help you discover content you can watch immediately.
Instructions
Discovers movies or TV shows available on specific streaming providers in a region. Input: type (optional: tv|movie, default tv), with_watch_providers (required comma-separated provider IDs), watch_region (required ISO 3166-1), language (optional ISO 639-1, default en), page (optional), sort_by (optional). Output: JSON with paginated results. Purpose: Personalized content discovery based on streaming availability for AI agents.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| language | No | ISO 639-1 language (e.g., en) | |
| page | No | Page number | |
| sort_by | No | Sort order (e.g., release_date.desc, first_air_date.desc, popularity.desc) | |
| type | No | Media type to discover: tv (default) or movie | |
| watch_region | Yes | ISO 3166-1 region code (e.g., IS) | |
| with_watch_providers | Yes | Provider ID(s), comma-separated (e.g., '8'), from service get_watch_providers |
Input Schema (JSON Schema)
{
"properties": {
"language": {
"description": "ISO 639-1 language (e.g., en)",
"type": "string"
},
"page": {
"description": "Page number",
"minimum": 1,
"type": "number"
},
"sort_by": {
"description": "Sort order (e.g., release_date.desc, first_air_date.desc, popularity.desc)",
"type": "string"
},
"type": {
"description": "Media type to discover: tv (default) or movie",
"enum": [
"tv",
"movie"
],
"type": "string"
},
"watch_region": {
"description": "ISO 3166-1 region code (e.g., IS)",
"type": "string"
},
"with_watch_providers": {
"description": "Provider ID(s), comma-separated (e.g., '8'), from service get_watch_providers",
"type": "string"
}
},
"required": [
"with_watch_providers",
"watch_region"
],
"type": "object"
}