> 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/title-overview.md).

# Title Overview

Title-level data, external IDs, presence, and distribution history

## Get title overview

> Retrieve title metadata and season/episode counts by UID

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Title Overview","description":"Title-level data, external IDs, presence, and distribution history"}],"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":{"TitleOverviewResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"year":{"type":"integer"},"type":{"type":"string"},"cast":{"type":"string"},"directors":{"type":"string"},"duration":{"type":"integer"},"poster":{"type":"string"},"synopsis":{"type":"string"},"country":{"type":"string"},"language":{"type":"string"},"genres":{"type":"string"},"num_seasons":{"type":"integer"},"num_episodes":{"type":"integer"}}}},"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/title_overview/title_data":{"get":{"summary":"Get title overview","description":"Retrieve title metadata and season/episode counts by UID","operationId":"getTitleOverview","tags":["Title Overview"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"uid","in":"query","description":"Content UID to retrieve overview details for","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleOverviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get title external IDs

> Retrieve external IDs for a title by UID

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Title Overview","description":"Title-level data, external IDs, presence, and distribution history"}],"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":{"TitleExternalIdsResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string"},"provider":{"type":"string"},"id":{"type":"string"},"type":{"type":"string"}}}},"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/title_overview/title_external_ids":{"get":{"summary":"Get title external IDs","description":"Retrieve external IDs for a title by UID","operationId":"getTitleExternalIds","tags":["Title Overview"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"uid","in":"query","description":"Content UID to retrieve external IDs for","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleExternalIdsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get title presence

> Retrieve platform presence data for a title by UID

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Title Overview","description":"Title-level data, external IDs, presence, and distribution history"}],"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":{"TitlePresenceResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"integer"},"platform_name":{"type":"string"},"platform_country":{"type":"string"},"deeplink":{"type":"string"},"is_original":{"type":"boolean"},"entry_date":{"type":"string","format":"date-time"},"business_model":{"type":"string"},"plan":{"type":"string"}}}},"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/title_overview/presence":{"get":{"summary":"Get title presence","description":"Retrieve platform presence data for a title by UID","operationId":"getTitlePresence","tags":["Title Overview"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"uid","in":"query","description":"Content UID to retrieve presence details for","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitlePresenceResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get title distribution history

> Retrieve monthly availability history for titles. Returns paginated rows grouped by uid, platform, country, and business model, each with a sorted array of months (YYYY/MM) where the title was available. At least one filter (uid, platform\_id, or platform\_country) is required.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Title Overview","description":"Title-level data, external IDs, presence, and distribution history"}],"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"]}},"PresentFrom":{"name":"present_from","in":"query","required":false,"description":"Filter to content that was present on or after this date (inclusive). Format YYYY-MM-DD. Uses interval overlap logic — content whose out_on is NULL or after this date. Only applies to historic catalog queries (historic overview endpoints and catalog with historical=true); ignored otherwise.","schema":{"type":"string","format":"date"}},"PresentTo":{"name":"present_to","in":"query","required":false,"description":"Filter to content that entered before this date (exclusive). Format YYYY-MM-DD. Uses interval overlap logic — content whose enter_on is before this date. Only applies to historic catalog queries (historic overview endpoints and catalog with historical=true); ignored otherwise.","schema":{"type":"string","format":"date"}},"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"}},"PlanChannel":{"name":"plan_channel","in":"query","required":false,"description":"Filter by plan/channel name(s), comma-separated. Exact match against package_plan column.","schema":{"type":"string"}},"IsExclusive":{"name":"is_exclusive","in":"query","required":false,"description":"Filter by content exclusivity. Requires both country and platform params to be set. When \"true\", only includes content that is exclusive on the specified platform/country. When \"false\", excludes exclusive content.","schema":{"type":"string","enum":["true","false"]}},"IsLocal":{"name":"is_local","in":"query","required":false,"description":"Filter by local content. Requires both country and platform params to be set. When \"true\", only includes content whose primary production country matches the platform country. When \"false\", excludes local content.","schema":{"type":"string","enum":["true","false"]}}},"schemas":{"DistributionHistoryResponse":{"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"}}},"months":{"type":"array","description":"Shared timeline of YYYY/MM strings from the earliest surveyed date to the current month","items":{"type":"string"}},"data":{"type":"array","description":"Each element represents a single UID. Pagination is by UID count.","items":{"type":"object","properties":{"uid":{"type":"string"},"title":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"poster":{"type":"string","nullable":true},"rows":{"type":"array","description":"Platform/country/business_model combinations for this UID","items":{"type":"object","properties":{"platform_id":{"type":"integer"},"platform_name":{"type":"string"},"platform_logo":{"type":"string","nullable":true},"platform_country":{"type":"string"},"business_model":{"type":"string"},"surveyed_since":{"type":"string","nullable":true,"description":"Date the platform was added (from platforms_status)"},"presence":{"type":"array","description":"Array of [startIndex, endIndex] (inclusive) ranges referencing the months array. Each range is a contiguous block where the title was available. Example: [[2, 4], [10, 15]]","items":{"type":"array","items":{"type":"integer"},"minItems":2,"maxItems":2}}}}}}}},"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/title_overview/distribution_history":{"get":{"summary":"Get title distribution history","description":"Retrieve monthly availability history for titles. Returns paginated rows grouped by uid, platform, country, and business model, each with a sorted array of months (YYYY/MM) where the title was available. At least one filter (uid, platform_id, or platform_country) is required.","operationId":"getTitleDistributionHistory","tags":["Title Overview"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"uid","in":"query","description":"Comma-separated content UIDs to retrieve distribution history for","required":false,"schema":{"type":"string"}},{"name":"platform_id","in":"query","description":"Comma-separated platform IDs to filter by","required":false,"schema":{"type":"string"}},{"name":"country_iso","in":"query","description":"Comma-separated ISO country codes to filter by","required":false,"schema":{"type":"string"}},{"name":"business_model","in":"query","description":"Comma-separated business models to filter by (e.g. Subscription, Transactional)","required":false,"schema":{"type":"string"}},{"$ref":"#/components/parameters/PresentFrom"},{"$ref":"#/components/parameters/PresentTo"},{"$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/PlanChannel"},{"$ref":"#/components/parameters/IsExclusive"},{"$ref":"#/components/parameters/IsLocal"},{"name":"scripted","in":"query","description":"Filter by scripted flag, comma-separated (e.g. \"Scripted\", \"Non-Scripted\")","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"historical (default) returns all records; current returns only currently available titles (out_on IS NULL)","required":false,"schema":{"type":"string","enum":["historical","current"],"default":"historical"}},{"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 results per page (default 50)","required":false,"schema":{"type":"integer","minimum":1,"default":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DistributionHistoryResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```