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

# Awards

Awards data by genre, platform, title, person, and upcoming events

## Get awards by genre

> Returns nomination and win counts per primary genre, aggregated from content awards data scoped to platform catalog

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsGenresResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"genre":{"type":"string"},"nominations":{"type":"integer"},"wins":{"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/awards/genres":{"get":{"summary":"Get awards by genre","description":"Returns nomination and win counts per primary genre, aggregated from content awards data scoped to platform catalog","operationId":"getAwardsGenres","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated country ISO codes to filter by title origin country (content_metadata.primary_country_iso)","schema":{"type":"string"}},{"name":"platform_country","in":"query","required":false,"description":"Comma-separated country ISO codes to filter by platform operating country (content_presence.platform_country)","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsGenresResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards by platform (originals only)

> Returns nomination and win counts per platform, scoped to original content (is\_original = true). Uses COUNT(DISTINCT uid) for deduplication.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsPlatformsResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"platform_id":{"type":"integer"},"platform_name":{"type":"string"},"nominations":{"type":"integer"},"wins":{"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/awards/platforms":{"get":{"summary":"Get awards by platform (originals only)","description":"Returns nomination and win counts per platform, scoped to original content (is_original = true). Uses COUNT(DISTINCT uid) for deduplication.","operationId":"getAwardsPlatforms","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated country ISO codes to filter by title origin country (content_metadata.primary_country_iso)","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsPlatformsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards by title

> Returns individual titles with their award nomination and win counts, with pagination. Filters by platform, award name, country, and year range.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsTitlesResponse":{"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"},"title":{"type":"string"},"type":{"type":"string"},"poster_image":{"type":"string","nullable":true},"nominations":{"type":"integer"},"wins":{"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/awards/titles":{"get":{"summary":"Get awards by title","description":"Returns individual titles with their award nomination and win counts, with pagination. Filters by platform, award name, country, and year range.","operationId":"getAwardsTitles","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated country ISO codes to filter by title origin country (content_metadata.primary_country_iso)","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of items per page (default 100)","schema":{"type":"integer","default":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsTitlesResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards per title detail table

> Returns individual award entries per title (event, category, subcategory, year, classification) with pagination. Used to power the "Awards per Title" detail table.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsTitlesTableResponse":{"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"},"title":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string"},"categories":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"subcategories":{"type":"array","items":{"type":"object","properties":{"subcategory":{"type":"string","nullable":true},"results":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"classification":{"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/awards/titles_table":{"get":{"summary":"Get awards per title detail table","description":"Returns individual award entries per title (event, category, subcategory, year, classification) with pagination. Used to power the \"Awards per Title\" detail table.","operationId":"getAwardsTitlesTable","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated award territory codes to filter by","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of items per page (default 50)","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsTitlesTableResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards per person

> Returns award entries grouped by person (event, category, subcategory, year, classification) with pagination. Only includes rows where person\_name exists.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsPersonAwardsResponse":{"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":{"person_name":{"type":"string"},"events":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string"},"categories":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"subcategories":{"type":"array","items":{"type":"object","properties":{"subcategory":{"type":"string","nullable":true},"results":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer"},"classification":{"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/awards/person_awards":{"get":{"summary":"Get awards per person","description":"Returns award entries grouped by person (event, category, subcategory, year, classification) with pagination. Only includes rows where person_name exists.","operationId":"getAwardsPersonAwards","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated award territory codes to filter by","schema":{"type":"string"}},{"name":"person_name","in":"query","required":false,"description":"Comma-separated person names to filter by","schema":{"type":"string"}},{"name":"event","in":"query","required":false,"description":"Comma-separated event names to filter by","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Comma-separated category names to filter by","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of items per page (default 50)","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsPersonAwardsResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards database

> Returns a flat paginated table of award-level detail rows enriched with content metadata fields. Serves as a comprehensive awards database view filterable by platform, country, and award criteria.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsDatabaseResponse":{"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"},"person_name":{"type":"string","nullable":true},"year":{"type":"integer"},"content_type":{"type":"string"},"category":{"type":"string"},"subcategory":{"type":"string","nullable":true},"event":{"type":"string"},"type":{"type":"string"},"award_country":{"type":"string"},"production_countries":{"type":"string","nullable":true},"genres":{"type":"string","nullable":true},"production_companies":{"type":"string","nullable":true},"launch_year":{"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/awards/database":{"get":{"summary":"Get awards database","description":"Returns a flat paginated table of award-level detail rows enriched with content metadata fields. Serves as a comprehensive awards database view filterable by platform, country, and award criteria.","operationId":"getAwardsDatabase","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated award territory codes to filter by","schema":{"type":"string"}},{"name":"platform_country","in":"query","required":false,"description":"Comma-separated platform country codes to filter by","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of items per page (default 50)","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsDatabaseResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get upcoming award events

> Returns a paginated list of upcoming award events with their scheduled dates and countries. Events without a confirmed date show as null. Filterable by country.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"UpcomingEventsResponse":{"type":"object","properties":{"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string"},"country":{"type":"string"},"event_day":{"type":"string","nullable":true,"format":"date-time"}}}},"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/awards/upcoming_events":{"get":{"summary":"Get upcoming award events","description":"Returns a paginated list of upcoming award events with their scheduled dates and countries. Events without a confirmed date show as null. Filterable by country.","operationId":"getUpcomingEvents","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"country","in":"query","required":false,"description":"Comma-separated country names to filter by","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer","default":1}},{"name":"page_size","in":"query","required":false,"description":"Number of items per page (default 50)","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpcomingEventsResponse"}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Get awards by production country

> Returns award nomination and win counts grouped by production country ISO code. Unnests the countries\_iso array from content\_metadata so each production country is counted individually.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API","version":"1.0.0"},"tags":[{"name":"Awards","description":"Awards data by genre, platform, title, person, and upcoming events"}],"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":{"AwardsProductionCountriesResponse":{"type":"object","properties":{"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"country_iso":{"type":"string"},"nominations":{"type":"integer"},"wins":{"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/awards/production_countries":{"get":{"summary":"Get awards by production country","description":"Returns award nomination and win counts grouped by production country ISO code. Unnests the countries_iso array from content_metadata so each production country is counted individually.","operationId":"getAwardsProductionCountries","tags":["Awards"],"parameters":[{"$ref":"#/components/parameters/ApiKeyHeader"},{"$ref":"#/components/parameters/CacheBypass"},{"name":"platform","in":"query","required":false,"description":"Comma-separated platform IDs to filter by","schema":{"type":"string"}},{"name":"award_name","in":"query","required":false,"description":"Comma-separated award event names to filter by","schema":{"type":"string"}},{"name":"award_country","in":"query","required":false,"description":"Comma-separated award territory codes to filter by","schema":{"type":"string"}},{"name":"year_min","in":"query","required":false,"description":"Minimum award year (inclusive)","schema":{"type":"integer"}},{"name":"year_max","in":"query","required":false,"description":"Maximum award year (inclusive)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AwardsProductionCountriesResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```