> 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"}}}}}}
```