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


---

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