> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/insights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/insights/api/top-ten.md).

# Top Ten

Top ten rankings, KPIs, genres, production countries, and cross-market performance

## Get top ten titles

> Returns paginated top ten titles grouped by platform, type, country, and date with ranking data, metadata, and filtering support.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}},"MetaPrimaryCompany":{"name":"primary_company","in":"query","required":false,"description":"Filter by primary producer company name(s), comma-separated","schema":{"type":"string"}},"MetaProductionCompanies":{"name":"production_companies","in":"query","required":false,"description":"Filter by production company name(s), comma-separated. Matches titles where any listed company appears in the production_companies field","schema":{"type":"string"}},"MetaYearMin":{"name":"year_min","in":"query","required":false,"description":"Filter by minimum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaYearMax":{"name":"year_max","in":"query","required":false,"description":"Filter by maximum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaPrimaryCountryIso":{"name":"primary_country_iso","in":"query","required":false,"description":"Filter by primary production country ISO code(s), comma-separated","schema":{"type":"string"}},"MetaCountriesIso":{"name":"countries_iso","in":"query","required":false,"description":"Filter by production location ISO code(s), comma-separated. Matches titles where any listed country appears in the countries_iso field","schema":{"type":"string"}},"MetaCast":{"name":"cast","in":"query","required":false,"description":"Filter by cast member name (partial match, case-sensitive)","schema":{"type":"string"}},"MetaKeywords":{"name":"keywords","in":"query","required":false,"description":"Filter by keyword(s), comma-separated. Matches titles where any listed keyword appears in the keywords field","schema":{"type":"string"}},"MetaPrimaryGenre":{"name":"primary_genre","in":"query","required":false,"description":"Filter by primary genre(s), comma-separated","schema":{"type":"string"}},"MetaGenres":{"name":"genres","in":"query","required":false,"description":"Filter by genre(s), comma-separated. Matches titles where any listed genre appears in the genres field","schema":{"type":"string"}},"MetaType":{"name":"type","in":"query","required":false,"description":"Filter by content type, comma-separated","schema":{"type":"string","enum":["Movie","Series"]}}},"schemas":{"TopTenTopTitlesResponse":{"type":"object","properties":{"message":{"type":"string"},"pagination":{"type":"object","properties":{"total_items":{"type":"integer"},"total_pages":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"platform_name":{"type":"string"},"top_type":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"date":{"type":"string","format":"date"},"rank":{"type":"integer"},"poster":{"type":"string","nullable":true},"title":{"type":"string"},"type":{"type":"string"},"year":{"type":"string","nullable":true},"production_country":{"type":"string","nullable":true},"original":{"type":"string","nullable":true},"genres":{"type":"string","nullable":true},"scripted":{"type":"string","nullable":true},"local":{"type":"string","nullable":true},"regional":{"type":"string","nullable":true},"deeplink":{"type":"string","nullable":true},"entered":{"type":"string","format":"date","nullable":true},"new_on_top":{"type":"string","nullable":true},"ranking_score":{"type":"string","nullable":true},"imdb_id":{"type":"string","nullable":true},"multiple_country_reach":{"type":"string","nullable":true}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"BadRequest":{"description":"Bad request - invalid parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/top_titles":{"get":{"summary":"Get top ten titles","description":"Returns paginated top ten titles grouped by platform, type, country, and date with ranking data, metadata, and filtering support.","operationId":"getTopTenTopTitles","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"uid","in":"query","required":false,"description":"Filter by content UID(s), comma-separated","schema":{"type":"string"}},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"Top type filter (comma-separated for multiple, e.g. Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","description":"Page number (default 1)","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"page_size","in":"query","description":"Number of items per page (default 50)","required":false,"schema":{"type":"integer","minimum":1,"default":50}},{"$ref":"#/components/parameters/MetaPrimaryCompany"},{"$ref":"#/components/parameters/MetaProductionCompanies"},{"$ref":"#/components/parameters/MetaYearMin"},{"$ref":"#/components/parameters/MetaYearMax"},{"$ref":"#/components/parameters/MetaPrimaryCountryIso"},{"$ref":"#/components/parameters/MetaCountriesIso"},{"$ref":"#/components/parameters/MetaCast"},{"$ref":"#/components/parameters/MetaKeywords"},{"$ref":"#/components/parameters/MetaPrimaryGenre"},{"$ref":"#/components/parameters/MetaGenres"},{"$ref":"#/components/parameters/MetaType"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenTopTitlesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten KPIs

> Returns aggregate KPI metrics for top ten titles including total contents, new entries, movies, series, seasons, episodes, released in current year, and average score.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenKpisResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"object","properties":{"total_contents":{"type":"integer","description":"Count of unique titles"},"new_entries":{"type":"integer","description":"Count of unique titles where new_on_top is Yes"},"movies":{"type":"integer","description":"Count of unique titles of type Movie"},"series":{"type":"integer","description":"Count of unique titles of type Series"},"total_seasons":{"type":"integer","description":"Sum of seasons across unique titles"},"total_episodes":{"type":"integer","description":"Sum of episodes across unique titles"},"released_2026":{"type":"integer","description":"Count of unique titles released in 2026"},"average_score":{"type":"number","format":"double","description":"Average score across unique titles"}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/kpis":{"get":{"summary":"Get top ten KPIs","description":"Returns aggregate KPI metrics for top ten titles including total contents, new entries, movies, series, seasons, episodes, released in current year, and average score.","operationId":"getTopTenKpis","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenKpisResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten local contents breakdown

> Returns a breakdown of local vs non-local content among top ten titles, with counts and percentages by distinct uid.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenLocalContentsResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"is_local":{"type":"string","description":"Whether the content is local (Yes/No)"},"count":{"type":"integer","description":"Number of distinct titles"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/local_contents":{"get":{"summary":"Get top ten local contents breakdown","description":"Returns a breakdown of local vs non-local content among top ten titles, with counts and percentages by distinct uid.","operationId":"getTopTenLocalContents","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenLocalContentsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten content age distribution

> Returns the age distribution of top ten titles by joining with content\_metadata, with counts and percentages by distinct uid.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenContentAgeResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string","description":"Age bucket from content_metadata (e.g. Less than a year, 1-3 years, 4-7 years, +7 years)"},"count":{"type":"integer","description":"Number of distinct titles"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/content_age":{"get":{"summary":"Get top ten content age distribution","description":"Returns the age distribution of top ten titles by joining with content_metadata, with counts and percentages by distinct uid.","operationId":"getTopTenContentAge","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenContentAgeResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten contents per genre

> Returns genre distribution of top ten titles by unwinding the genres column, with counts and percentages by distinct uid.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenGenresResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"genre":{"type":"string","description":"Genre name"},"count":{"type":"integer","description":"Number of distinct titles with this genre"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/genres":{"get":{"summary":"Get top ten contents per genre","description":"Returns genre distribution of top ten titles by unwinding the genres column, with counts and percentages by distinct uid.","operationId":"getTopTenGenres","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenGenresResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten original contents by platform

> Returns per-platform breakdown of original vs non-original content among top ten titles, with counts by distinct uid.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenOriginalContentsResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"platform_name":{"type":"string","description":"Platform name"},"original_yes":{"type":"integer","description":"Count of original titles (is_original = Yes)"},"original_no":{"type":"integer","description":"Count of non-original titles"},"total":{"type":"integer","description":"Total distinct titles on this platform"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/original_contents":{"get":{"summary":"Get top ten original contents by platform","description":"Returns per-platform breakdown of original vs non-original content among top ten titles, with counts by distinct uid.","operationId":"getTopTenOriginalContents","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenOriginalContentsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get top ten production countries

> Returns the count and percentage of distinct titles per origin/production country among top ten titles, unwinding the comma-separated origin\_countries field.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"TopTenProductionCountriesResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"origin_country":{"type":"string","description":"Production/origin country code"},"count":{"type":"integer","description":"Number of distinct titles from this country"},"percentage":{"type":"number","format":"double","description":"Percentage of total titles"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/production_countries":{"get":{"summary":"Get top ten production countries","description":"Returns the count and percentage of distinct titles per origin/production country among top ten titles, unwinding the comma-separated origin_countries field.","operationId":"getTopTenProductionCountries","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTenProductionCountriesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get new entry titles in top ten

> Returns a paginated list of titles that are new entries in the top ten lists, with their platform, top type, position, and date.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"NewEntriesResponse":{"type":"object","properties":{"message":{"type":"string"},"pagination":{"type":"object","properties":{"total_items":{"type":"integer"},"total_pages":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Title name"},"poster":{"type":"string","description":"URL to the title poster image"},"platform_name":{"type":"string","description":"Platform name"},"top_type":{"type":"string","description":"Top list type"},"position":{"type":"integer","description":"Position in the top list"},"date":{"type":"string","format":"date","description":"Date of the top list entry"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/new_entries":{"get":{"summary":"Get new entry titles in top ten","description":"Returns a paginated list of titles that are new entries in the top ten lists, with their platform, top type, position, and date.","operationId":"getNewEntries","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","description":"Page number (default 1)","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"page_size","in":"query","description":"Number of items per page (default 50)","required":false,"schema":{"type":"integer","default":50,"minimum":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewEntriesResponse"}}}},"400":{"description":"Invalid query parameters"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get titles that perform well across markets

> Returns a paginated list of titles that perform well across multiple countries on the same platform, grouped by title and platform with a country count.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"CrossMarketPerformanceResponse":{"type":"object","properties":{"message":{"type":"string"},"pagination":{"type":"object","properties":{"total_items":{"type":"integer"},"total_pages":{"type":"integer"},"page":{"type":"integer"},"page_size":{"type":"integer"}}},"data":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Unique identifier for the title"},"title":{"type":"string","description":"Title name"},"poster":{"type":"string","description":"URL to the title poster image"},"platform_name":{"type":"string","description":"Platform name"},"top_type":{"type":"string","description":"Top list type"},"type":{"type":"string","description":"Content type"},"country_count":{"type":"integer","description":"Number of distinct countries where this title performs well on this platform"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/cross_market_performance":{"get":{"summary":"Get titles that perform well across markets","description":"Returns a paginated list of titles that perform well across multiple countries on the same platform, grouped by title and platform with a country count.","operationId":"getCrossMarketPerformance","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (comma-separated, e.g. Overall, Movies, TV Shows, Kids)","required":false,"schema":{"type":"string"}},{"name":"content_type","in":"query","description":"Content type filter (comma-separated, e.g. Movie, Series)","required":false,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","description":"Page number (default 1)","required":false,"schema":{"type":"integer","default":1,"minimum":1}},{"name":"page_size","in":"query","description":"Number of items per page (default 50)","required":false,"schema":{"type":"integer","default":50,"minimum":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossMarketPerformanceResponse"}}}},"400":{"description":"Invalid query parameters"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get position evolution per title over time

> Returns titles grouped by UID with their daily position on the top-ten list over a date range. Titles are ordered by best average position (ascending). Requires platform, country, and top\_type filters.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}}},"schemas":{"PositionEvolutionResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Unique identifier for the title"},"title":{"type":"string","description":"Title name"},"poster":{"type":"string","description":"URL to the title poster image"},"positions":{"type":"array","description":"Array of daily positions ordered chronologically","items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date of the position entry"},"position":{"type":"integer","description":"Position on the top-ten list"}}}}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/position_evolution":{"get":{"summary":"Get position evolution per title over time","description":"Returns titles grouped by UID with their daily position on the top-ten list over a date range. Titles are ordered by best average position (ascending). Requires platform, country, and top_type filters.","operationId":"getPositionEvolution","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","description":"Platform name filter (comma-separated for multiple)","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Country ISO code filter (comma-separated for multiple)","required":true,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (e.g. Overall, Movies, TV Shows, Kids)","required":true,"schema":{"type":"string"}},{"name":"title","in":"query","description":"Title name filter (comma-separated for multiple)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter entries on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter entries on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionEvolutionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get ranking score entries per date

> Returns all top-ten entries per date for a given platform, country, and top type (10 entries per date). Sorted by date descending, then position ascending. Requires country, platform, and top\_type filters.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}},"MetaPrimaryCompany":{"name":"primary_company","in":"query","required":false,"description":"Filter by primary producer company name(s), comma-separated","schema":{"type":"string"}},"MetaProductionCompanies":{"name":"production_companies","in":"query","required":false,"description":"Filter by production company name(s), comma-separated. Matches titles where any listed company appears in the production_companies field","schema":{"type":"string"}},"MetaYearMin":{"name":"year_min","in":"query","required":false,"description":"Filter by minimum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaYearMax":{"name":"year_max","in":"query","required":false,"description":"Filter by maximum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaPrimaryCountryIso":{"name":"primary_country_iso","in":"query","required":false,"description":"Filter by primary production country ISO code(s), comma-separated","schema":{"type":"string"}},"MetaCountriesIso":{"name":"countries_iso","in":"query","required":false,"description":"Filter by production location ISO code(s), comma-separated. Matches titles where any listed country appears in the countries_iso field","schema":{"type":"string"}},"MetaCast":{"name":"cast","in":"query","required":false,"description":"Filter by cast member name (partial match, case-sensitive)","schema":{"type":"string"}},"MetaKeywords":{"name":"keywords","in":"query","required":false,"description":"Filter by keyword(s), comma-separated. Matches titles where any listed keyword appears in the keywords field","schema":{"type":"string"}},"MetaPrimaryGenre":{"name":"primary_genre","in":"query","required":false,"description":"Filter by primary genre(s), comma-separated","schema":{"type":"string"}},"MetaGenres":{"name":"genres","in":"query","required":false,"description":"Filter by genre(s), comma-separated. Matches titles where any listed genre appears in the genres field","schema":{"type":"string"}},"MetaType":{"name":"type","in":"query","required":false,"description":"Filter by content type, comma-separated","schema":{"type":"string","enum":["Movie","Series"]}}},"schemas":{"RankingScoreResponse":{"type":"object","properties":{"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Unique identifier for the title"},"title":{"type":"string","description":"Title name"},"poster":{"type":"string","description":"URL to the title poster image"},"date":{"type":"string","description":"Date of the top-ten entry"},"position":{"type":"integer","description":"Position in the top-ten list (1-10)"},"score":{"type":"number","format":"float","description":"Score for this entry"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/ranking_score":{"get":{"summary":"Get ranking score entries per date","description":"Returns all top-ten entries per date for a given platform, country, and top type (10 entries per date). Sorted by date descending, then position ascending. Requires country, platform, and top_type filters.","operationId":"getRankingScore","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"country","in":"query","description":"Country ISO code(s), comma-separated for multiple (e.g. AR or AR,US,BR)","required":true,"schema":{"type":"string"}},{"name":"platform","in":"query","description":"Platform name(s), comma-separated for multiple (e.g. Netflix or Netflix,Prime Video)","required":true,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter(s), comma-separated for multiple (e.g. Movies or Movies,TV Shows)","required":false,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter dates on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter dates on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"$ref":"#/components/parameters/MetaPrimaryCompany"},{"$ref":"#/components/parameters/MetaProductionCompanies"},{"$ref":"#/components/parameters/MetaYearMin"},{"$ref":"#/components/parameters/MetaYearMax"},{"$ref":"#/components/parameters/MetaPrimaryCountryIso"},{"$ref":"#/components/parameters/MetaCountriesIso"},{"$ref":"#/components/parameters/MetaCast"},{"$ref":"#/components/parameters/MetaKeywords"},{"$ref":"#/components/parameters/MetaPrimaryGenre"},{"$ref":"#/components/parameters/MetaGenres"},{"$ref":"#/components/parameters/MetaType"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankingScoreResponse"}}}},"400":{"description":"Missing or invalid required parameters"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get score evolution per week for top titles

> Returns weekly score data for up to 20 titles on a given platform, country, and top type. Titles present in the latest week are prioritized, then ranked by accumulated score. Useful for building stream/area charts of score evolution over time.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Top Ten","description":"Top ten rankings, KPIs, genres, production countries, and cross-market performance"}],"servers":[{"url":"https://{apiId}.execute-api.{region}.amazonaws.com/{environment}","description":"AWS API Gateway","variables":{"apiId":{"default":"api-id","description":"API Gateway ID"},"region":{"default":"us-east-2","description":"AWS Region"},"environment":{"default":"dev","enum":["dev","prod"],"description":"Environment"}}}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication"}},"parameters":{"ApiKeyHeader":{"name":"x-api-key","in":"header","description":"API key for authentication","required":true,"schema":{"type":"string"}},"CacheBypass":{"name":"X-Cache-Bypass","in":"header","description":"Set to \"true\" to bypass cache and fetch fresh data","required":false,"schema":{"type":"string","enum":["true"]}},"MetaPrimaryCompany":{"name":"primary_company","in":"query","required":false,"description":"Filter by primary producer company name(s), comma-separated","schema":{"type":"string"}},"MetaProductionCompanies":{"name":"production_companies","in":"query","required":false,"description":"Filter by production company name(s), comma-separated. Matches titles where any listed company appears in the production_companies field","schema":{"type":"string"}},"MetaYearMin":{"name":"year_min","in":"query","required":false,"description":"Filter by minimum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaYearMax":{"name":"year_max","in":"query","required":false,"description":"Filter by maximum release year (inclusive, range 1800–2100)","schema":{"type":"integer","minimum":1800,"maximum":2100}},"MetaPrimaryCountryIso":{"name":"primary_country_iso","in":"query","required":false,"description":"Filter by primary production country ISO code(s), comma-separated","schema":{"type":"string"}},"MetaCountriesIso":{"name":"countries_iso","in":"query","required":false,"description":"Filter by production location ISO code(s), comma-separated. Matches titles where any listed country appears in the countries_iso field","schema":{"type":"string"}},"MetaCast":{"name":"cast","in":"query","required":false,"description":"Filter by cast member name (partial match, case-sensitive)","schema":{"type":"string"}},"MetaKeywords":{"name":"keywords","in":"query","required":false,"description":"Filter by keyword(s), comma-separated. Matches titles where any listed keyword appears in the keywords field","schema":{"type":"string"}},"MetaPrimaryGenre":{"name":"primary_genre","in":"query","required":false,"description":"Filter by primary genre(s), comma-separated","schema":{"type":"string"}},"MetaGenres":{"name":"genres","in":"query","required":false,"description":"Filter by genre(s), comma-separated. Matches titles where any listed genre appears in the genres field","schema":{"type":"string"}},"MetaType":{"name":"type","in":"query","required":false,"description":"Filter by content type, comma-separated","schema":{"type":"string","enum":["Movie","Series"]}}},"schemas":{"ScoreEvolutionResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Unique identifier for the title"},"title":{"type":"string","description":"Title name"},"poster":{"type":"string","description":"URL to the title poster image"},"date":{"type":"string","format":"date","description":"Week date"},"score":{"type":"number","format":"float","description":"Average score for this title on this week"}}}},"userId":{"type":"string","nullable":true},"cached":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/insights/content_pulse/top_ten/score_evolution":{"get":{"summary":"Get score evolution per week for top titles","description":"Returns weekly score data for up to 20 titles on a given platform, country, and top type. Titles present in the latest week are prioritized, then ranked by accumulated score. Useful for building stream/area charts of score evolution over time.","operationId":"getScoreEvolution","tags":["Top Ten"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"country","in":"query","description":"Country ISO code (e.g. AR, US)","required":true,"schema":{"type":"string"}},{"name":"platform","in":"query","description":"Platform name (e.g. Netflix, Prime Video)","required":true,"schema":{"type":"string"}},{"name":"top_type","in":"query","description":"Top type filter (e.g. All, Movies, TV Shows, Kids)","required":true,"schema":{"type":"string"}},{"name":"date_before","in":"query","description":"Filter dates on or before this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"name":"date_after","in":"query","description":"Filter dates on or after this date (YYYY-MM-DD)","required":false,"schema":{"type":"string","format":"date"}},{"$ref":"#/components/parameters/MetaPrimaryCompany"},{"$ref":"#/components/parameters/MetaProductionCompanies"},{"$ref":"#/components/parameters/MetaYearMin"},{"$ref":"#/components/parameters/MetaYearMax"},{"$ref":"#/components/parameters/MetaPrimaryCountryIso"},{"$ref":"#/components/parameters/MetaCountriesIso"},{"$ref":"#/components/parameters/MetaCast"},{"$ref":"#/components/parameters/MetaKeywords"},{"$ref":"#/components/parameters/MetaPrimaryGenre"},{"$ref":"#/components/parameters/MetaGenres"},{"$ref":"#/components/parameters/MetaType"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreEvolutionResponse"}}}},"400":{"description":"Missing or invalid required parameters"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledgebase.fabricdata.com/insights/api/top-ten.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.