{"openapi":"3.1.0","info":{"title":"Newsverum API","description":"Published multilingual news, structured data and event intelligence. Heavy processing is asynchronous.","version":"1.0.0"},"paths":{"/health/live":{"get":{"tags":["health"],"summary":"Live","operationId":"live_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Live Health Live Get"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health/ready":{"get":{"tags":["health"],"summary":"Ready","operationId":"ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadinessResponse"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Required dependency not ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadinessResponse"}}}}}}},"/api/v1/articles":{"get":{"tags":["articles"],"summary":"Articles","operationId":"articles_api_v1_articles_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"data_type","in":"query","required":false,"schema":{"type":"string","default":"","title":"Data Type"}},{"name":"subject","in":"query","required":false,"schema":{"type":"string","default":"","title":"Subject"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","default":"","title":"Country"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"newest","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleList"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/articles/{slug}":{"get":{"tags":["articles"],"summary":"Article Detail","operationId":"article_detail_api_v1_articles__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleResponse"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/articles/{slug}/data/{block_id}":{"get":{"tags":["articles"],"summary":"Download","operationId":"download_api_v1_articles__slug__data__block_id__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"block_id","in":"path","required":true,"schema":{"type":"string","title":"Block Id"}},{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1":{"get":{"tags":["articles"],"summary":"Description","operationId":"description_api_v1_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/canonical-schema":{"get":{"tags":["datasets"],"summary":"Canonical Schema","operationId":"canonical_schema_api_v1_canonical_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/article-schema":{"get":{"tags":["datasets"],"summary":"Article Contract","description":"The article file contract: what a contribution must satisfy before review.","operationId":"article_contract_api_v1_article_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/data-schema":{"get":{"tags":["datasets"],"summary":"Data Contract","operationId":"data_contract_api_v1_data_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/measure-catalog-schema":{"get":{"tags":["datasets"],"summary":"Contracts","operationId":"contracts_api_v1_measure_catalog_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/observations-schema":{"get":{"tags":["datasets"],"summary":"Contracts","operationId":"contracts_api_v1_observations_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/units":{"get":{"tags":["datasets"],"summary":"Units","operationId":"units_api_v1_units_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/measure-geographies":{"get":{"tags":["datasets"],"summary":"Measure Geographies","operationId":"measure_geographies_api_v1_measure_geographies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/observations":{"get":{"tags":["datasets"],"summary":"Observation List","operationId":"observation_list_api_v1_observations_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"basis","in":"query","required":false,"schema":{"type":"string","default":"observed","title":"Basis"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"period_asc","title":"Sort"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"snapshot","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/measure-catalog":{"get":{"tags":["datasets"],"summary":"Catalog List","operationId":"catalog_list_api_v1_measure_catalog_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/events":{"get":{"tags":["intelligence"],"summary":"Events","operationId":"events_api_v1_events_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/events/{identity}":{"get":{"tags":["intelligence"],"summary":"Event Detail","operationId":"event_detail_api_v1_events__identity__get","parameters":[{"name":"identity","in":"path","required":true,"schema":{"type":"string","title":"Identity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/search/vector":{"get":{"tags":["intelligence"],"summary":"Vector Search","operationId":"vector_search_api_v1_search_vector_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/signals":{"get":{"tags":["intelligence"],"summary":"Signals","operationId":"signals_api_v1_signals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/predictions":{"get":{"tags":["intelligence"],"summary":"Predictions","operationId":"predictions_api_v1_predictions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/admin/jobs":{"post":{"tags":["intelligence"],"summary":"Submit Job","operationId":"submit_job_api_v1_admin_jobs_post","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ArticleJobRequest"},{"$ref":"#/components/schemas/GlobalJobRequest"}],"title":"Data","discriminator":{"propertyName":"stage","mapping":{"language":"#/components/schemas/ArticleJobRequest","entities":"#/components/schemas/ArticleJobRequest","topics":"#/components/schemas/ArticleJobRequest","embeddings":"#/components/schemas/ArticleJobRequest","duplicates":"#/components/schemas/ArticleJobRequest","similarity":"#/components/schemas/ArticleJobRequest","clustering":"#/components/schemas/ArticleJobRequest","sentiment":"#/components/schemas/ArticleJobRequest","importance":"#/components/schemas/ArticleJobRequest","prediction":"#/components/schemas/ArticleJobRequest","pipeline":"#/components/schemas/ArticleJobRequest","signals":"#/components/schemas/GlobalJobRequest","datasets":"#/components/schemas/GlobalJobRequest"}}}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Administrative bearer token required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/admin/jobs/{identity}":{"get":{"tags":["intelligence"],"summary":"Job Status","operationId":"job_status_api_v1_admin_jobs__identity__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identity","in":"path","required":true,"schema":{"type":"string","title":"Identity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/admin/events/{source_id}/merge/{target_id}":{"post":{"tags":["intelligence"],"summary":"Merge Events","operationId":"merge_events_api_v1_admin_events__source_id__merge__target_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","title":"Source Id"}},{"name":"target_id","in":"path","required":true,"schema":{"type":"string","title":"Target Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Merge Events Api V1 Admin Events  Source Id  Merge  Target Id  Post"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/taxonomy":{"get":{"tags":["taxonomy and geography"],"summary":"Subject Index","operationId":"subject_index_api_v1_taxonomy_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"subject","in":"query","required":false,"schema":{"type":"string","default":"","title":"Subject"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxonomyView"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/taxonomy/catalog":{"get":{"tags":["taxonomy and geography"],"summary":"Concept Catalog","operationId":"concept_catalog_api_v1_taxonomy_catalog_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/annotation-schema":{"get":{"tags":["taxonomy and geography"],"summary":"Annotation Schema","operationId":"annotation_schema_api_v1_annotation_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/geography-schema":{"get":{"tags":["taxonomy and geography"],"summary":"Geography Schema","operationId":"geography_schema_api_v1_geography_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/geography":{"get":{"tags":["taxonomy and geography"],"summary":"Geography Catalog","operationId":"geography_catalog_api_v1_geography_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/datasets":{"get":{"tags":["versioned datasets"],"summary":"Latest Dataset","operationId":"latest_dataset_api_v1_datasets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DatasetCatalog"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/datasets/{revision}/{filename}":{"get":{"tags":["versioned datasets"],"summary":"Dataset File","operationId":"dataset_file_api_v1_datasets__revision___filename__get","parameters":[{"name":"revision","in":"path","required":true,"schema":{"type":"string","title":"Revision"}},{"name":"filename","in":"path","required":true,"schema":{"type":"string","title":"Filename"}}],"responses":{"200":{"description":"Immutable Parquet file or JSON manifest","content":{"application/vnd.apache.parquet":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/DatasetManifest"}}},"headers":{"ETag":{"schema":{"type":"string"}},"Cache-Control":{"schema":{"type":"string"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"304":{"description":"File unchanged; response body is empty"},"404":{"description":"Unknown revision or file"}}}},"/api/v1/wire":{"get":{"tags":["agents"],"summary":"Wire","description":"Newest stories one per line, or every new or changed story after a cursor.","operationId":"wire_api_v1_wire_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"Only changes after this time (ISO 8601), oldest first; use the poll line's cursor","title":"Since"},"description":"Only changes after this time (ISO 8601), oldest first; use the poll line's cursor"},{"name":"after","in":"query","required":false,"schema":{"type":"string","description":"Slug that breaks a tie at `since`, from the poll cursor","default":"","title":"After"},"description":"Slug that breaks a tie at `since`, from the poll cursor"},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"enum":["economy","business","finance","fiscal","energy","agriculture","technology","health","climate","environment","infrastructure","education","government","politics","security"],"type":"string"},{"type":"null"}],"title":"Section"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},{"type":"null"}],"title":"Topic"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Q"}},{"name":"detail","in":"query","required":false,"schema":{"enum":["summary","title"],"type":"string","default":"summary","title":"Detail"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":1,"title":"Page"}},{"name":"format","in":"query","required":false,"schema":{"enum":["text","json"],"type":"string","default":"text","title":"Format"}}],"responses":{"200":{"description":"One line per story","content":{"application/json":{"schema":{}},"text/plain":{}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/brief":{"get":{"tags":["agents"],"summary":"Brief","description":"Dates, summary, key points, figures, sources and corrections of up to 20 stories.","operationId":"brief_api_v1_brief_get","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string","maxLength":4200,"description":"Up to 20 comma-separated story ids such as `en/<slug>`","title":"Ids"},"description":"Up to 20 comma-separated story ids such as `en/<slug>`"}],"responses":{"200":{"description":"A few lines per story","content":{"application/json":{"schema":{}},"text/plain":{}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/figures":{"get":{"tags":["agents"],"summary":"Figures","description":"Typed figures from story data, newest period first, with each value's fitting eligibility.","operationId":"figures_api_v1_figures_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string","default":"en","title":"Lang"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"description":"Words in the value label or story title","default":"","title":"Q"},"description":"Words in the value label or story title"},{"name":"measure","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9-]{0,95}$"},{"type":"null"}],"title":"Measure"}},{"name":"geography","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9-]{0,95}$"},{"type":"null"}],"title":"Geography"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earliest period (YYYY, YYYY-MM or a date)","title":"From"},"description":"Earliest period (YYYY, YYYY-MM or a date)"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Latest period","title":"To"},"description":"Latest period"},{"name":"basis","in":"query","required":false,"schema":{"enum":["observed","estimate","forecast","target","all"],"type":"string","default":"observed","title":"Basis"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"enum":["text","json"],"type":"string","default":"text","title":"Format"}}],"responses":{"200":{"description":"One line per value","content":{"application/json":{"schema":{}},"text/plain":{}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/pages":{"get":{"tags":["presentation"],"summary":"Page","operationId":"page_api_v1_pages_get","parameters":[{"name":"path","in":"query","required":false,"schema":{"type":"string","description":"The site address to render, with its own query string: `/en/category/energy`, `/tr/?q=enerji&page=2`. Search, page and filters belong inside this address.","default":"/en/","title":"Path"},"description":"The site address to render, with its own query string: `/en/category/energy`, `/tr/?q=enerji&page=2`. Search, page and filters belong inside this address."},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"enum":["tr","en","ar","fr","es","de","pt"],"type":"string"},{"type":"null"}],"description":"Reader language for addresses without an edition prefix, such as the home redirect and not-found pages. An edition prefix in `path` always wins; the default is English.","title":"Lang"},"description":"Reader language for addresses without an edition prefix, such as the home redirect and not-found pages. An edition prefix in `path` always wins; the default is English."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponse"}}}},"413":{"description":"Request exceeds the body limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request failed schema validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error; details are not exposed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Dependency temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"APIError":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"fields":{"items":{"type":"string"},"type":"array","title":"Fields"}},"type":"object","required":["code","message"],"title":"APIError"},"ArticleAnnotation":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"id":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Id"},"article_id":{"type":"string","title":"Article Id"},"input_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Input Sha256"},"taxonomy_revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Taxonomy Revision"},"taxonomy_version":{"type":"string","title":"Taxonomy Version"},"rules_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Rules Sha256"},"geography_revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Geography Revision"},"method":{"type":"string","const":"controlled-rules-v1","title":"Method","default":"controlled-rules-v1"},"available_at":{"type":"string","format":"date-time","title":"Available At"},"subjects":{"items":{"$ref":"#/components/schemas/SubjectLabel"},"type":"array","title":"Subjects"},"places":{"items":{"$ref":"#/components/schemas/PlaceAnnotation"},"type":"array","title":"Places"},"limitations":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Limitations"}},"additionalProperties":false,"type":"object","required":["id","article_id","input_sha256","taxonomy_revision","taxonomy_version","rules_sha256","geography_revision","available_at","limitations"],"title":"ArticleAnnotation"},"ArticleJobRequest":{"properties":{"stage":{"type":"string","enum":["language","entities","topics","embeddings","duplicates","similarity","clustering","sentiment","importance","prediction","pipeline"],"title":"Stage"},"article_id":{"type":"string","maxLength":180,"minLength":1,"title":"Article Id"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"additionalProperties":false,"type":"object","required":["stage","article_id"],"title":"ArticleJobRequest"},"ArticleList":{"properties":{"version":{"type":"string","title":"Version","default":"1"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size","default":20},"total":{"type":"integer","title":"Total"},"total_pages":{"type":"integer","title":"Total Pages"},"filters":{"additionalProperties":true,"type":"object","title":"Filters"},"links":{"$ref":"#/components/schemas/Links"},"articles":{"items":{"$ref":"#/components/schemas/PublicArticle"},"type":"array","title":"Articles"}},"type":"object","required":["language","page","total","total_pages","filters","links","articles"],"title":"ArticleList"},"ArticleResponse":{"properties":{"version":{"type":"string","title":"Version","default":"1"},"article":{"$ref":"#/components/schemas/PublicArticle"}},"type":"object","required":["article"],"title":"ArticleResponse"},"AssetVariant":{"properties":{"url":{"type":"string","title":"Url"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"}},"type":"object","required":["url","width","height"],"title":"AssetVariant"},"ColumnDefinition":{"properties":{"type":{"type":"string","enum":["str","int","float","bool","date","datetime","list","releases"],"title":"Type"},"description":{"type":"string","title":"Description"}},"additionalProperties":false,"type":"object","required":["type","description"],"title":"ColumnDefinition"},"Content":{"properties":{"paragraphs":{"items":{"type":"string"},"type":"array","title":"Paragraphs"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"sections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sections"}},"type":"object","required":["paragraphs","key_points","sections"],"title":"Content"},"CountryFacet":{"properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$","title":"Code"},"label":{"type":"string","title":"Label"},"label_language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Label Language"},"count":{"type":"integer","minimum":0.0,"title":"Count"}},"type":"object","required":["code","label","label_language","count"],"title":"CountryFacet"},"Coverage":{"properties":{"articles":{"type":"integer","minimum":0.0,"title":"Articles"},"editions":{"type":"integer","minimum":0.0,"title":"Editions"},"sources":{"type":"integer","minimum":0.0,"title":"Sources"},"data_articles":{"type":"integer","minimum":0.0,"title":"Data Articles"},"categories":{"additionalProperties":{"type":"integer"},"type":"object","title":"Categories"},"latest_publication":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Publication"}},"type":"object","required":["articles","editions","sources","data_articles","categories"],"title":"Coverage"},"Crumb":{"properties":{"name":{"type":"string","title":"Name"},"url":{"type":"string","title":"Url"}},"type":"object","required":["name","url"],"title":"Crumb"},"DatasetCatalog":{"properties":{"schema_version":{"type":"integer","enum":[1,2],"title":"Schema Version","default":1},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Revision"},"article_rows":{"type":"integer","minimum":0.0,"title":"Article Rows"},"observation_rows":{"type":"integer","minimum":0.0,"title":"Observation Rows"},"edition_rows":{"type":"integer","minimum":0.0,"title":"Edition Rows"},"annotation_rows":{"type":"integer","minimum":0.0,"title":"Annotation Rows"},"label_rows":{"type":"integer","minimum":0.0,"title":"Label Rows"},"block_rows":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Block Rows"},"files":{"additionalProperties":{"type":"string","pattern":"^[a-f0-9]{64}$"},"type":"object","title":"Files"},"sizes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sizes"},"watermarks":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Watermarks","description":"Latest first publication, modification and availability in the snapshot"},"columns":{"anyOf":[{"additionalProperties":{"additionalProperties":{"$ref":"#/components/schemas/ColumnDefinition"},"type":"object"},"type":"object"},{"type":"null"}],"title":"Columns","description":"Type and meaning of every column, per file"},"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"license":{"type":"null","title":"License"},"license_note":{"type":"string","title":"License Note"},"downloads":{"additionalProperties":{"type":"string"},"type":"object","title":"Downloads"}},"additionalProperties":false,"type":"object","required":["revision","article_rows","observation_rows","edition_rows","annotation_rows","label_rows","files","sizes","history","notes","license_note","downloads"],"title":"DatasetCatalog"},"DatasetManifest":{"properties":{"schema_version":{"type":"integer","enum":[1,2],"title":"Schema Version","default":1},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Revision"},"article_rows":{"type":"integer","minimum":0.0,"title":"Article Rows"},"observation_rows":{"type":"integer","minimum":0.0,"title":"Observation Rows"},"edition_rows":{"type":"integer","minimum":0.0,"title":"Edition Rows"},"annotation_rows":{"type":"integer","minimum":0.0,"title":"Annotation Rows"},"label_rows":{"type":"integer","minimum":0.0,"title":"Label Rows"},"block_rows":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Block Rows"},"files":{"additionalProperties":{"type":"string","pattern":"^[a-f0-9]{64}$"},"type":"object","title":"Files"},"sizes":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sizes"},"watermarks":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Watermarks","description":"Latest first publication, modification and availability in the snapshot"},"columns":{"anyOf":[{"additionalProperties":{"additionalProperties":{"$ref":"#/components/schemas/ColumnDefinition"},"type":"object"},"type":"object"},{"type":"null"}],"title":"Columns","description":"Type and meaning of every column, per file"},"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"license":{"type":"null","title":"License"},"license_note":{"type":"string","title":"License Note"}},"additionalProperties":false,"type":"object","required":["revision","article_rows","observation_rows","edition_rows","annotation_rows","label_rows","files","sizes","history","notes","license_note"],"title":"DatasetManifest","description":"A registered snapshot. Version 2 adds blocks.parquet, typed columns, the data dictionary and\nwatermarks; registered version 1 snapshots stay as they were published."},"EditorialIllustration":{"properties":{"kind":{"type":"string","const":"symbolic-editorial-illustration","title":"Kind","default":"symbolic-editorial-illustration"},"documentary":{"type":"boolean","const":false,"title":"Documentary","default":false},"scope":{"type":"string","title":"Scope"},"asset_id":{"type":"string","title":"Asset Id"},"url":{"type":"string","title":"Url"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"},"alt":{"type":"string","title":"Alt"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"variants":{"items":{"$ref":"#/components/schemas/AssetVariant"},"type":"array","title":"Variants","description":"WebP renditions, narrowest first"},"avif_variants":{"items":{"$ref":"#/components/schemas/AssetVariant"},"type":"array","title":"Avif Variants","description":"The same renditions as AVIF, smaller at equal quality"},"credit":{"type":"string","title":"Credit","default":"Newsverum"}},"type":"object","required":["scope","asset_id","url","width","height","alt","language","variants"],"title":"EditorialIllustration"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/APIError"}},"type":"object","required":["error"],"title":"ErrorResponse"},"Evidence":{"properties":{"source_urls":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Source Urls"},"field":{"type":"string","minLength":1,"title":"Field"},"note":{"type":"string","minLength":1,"title":"Note"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language","default":"en"}},"additionalProperties":false,"type":"object","required":["source_urls","field","note"],"title":"Evidence"},"ExploreCount":{"properties":{"key":{"type":"string","title":"Key"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["key","count"],"title":"ExploreCount"},"ExploreFigure":{"properties":{"value":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Value"},"value_qualifier":{"anyOf":[{"type":"string","enum":["exact","approximate","lower-bound","upper-bound"]},{"type":"null"}],"title":"Value Qualifier"},"unit":{"type":"string","title":"Unit"},"unit_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit Code","description":"Registered unit code, when the unit is registered"},"dimension":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dimension","description":"Unit dimension from the unit registry"},"period":{"type":"string","title":"Period"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"basis":{"type":"string","enum":["observed","estimate","forecast","target"],"title":"Basis"},"label":{"type":"string","title":"Label"},"label_language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Label Language"},"article_title":{"type":"string","title":"Article Title"},"article_language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Article Language"},"article_url":{"type":"string","title":"Article Url"},"event_period":{"type":"string","title":"Event Period"},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country"},"country_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Label"}},"type":"object","required":["value","unit","period","basis","label","label_language","article_title","article_language","article_url","event_period"],"title":"ExploreFigure","description":"One stored data-block value, exactly as published; units are never converted."},"ExploreTimeline":{"properties":{"weeks":{"items":{"$ref":"#/components/schemas/ExploreWeek"},"type":"array","title":"Weeks"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End","description":"Latest first-publication day; the last week contains it"},"counted":{"type":"integer","minimum":0.0,"title":"Counted","default":0},"excluded":{"type":"integer","minimum":0.0,"title":"Excluded","description":"Stories dated only to a month or year, or outside the weeks shown","default":0}},"type":"object","title":"ExploreTimeline"},"ExploreTotals":{"properties":{"articles":{"type":"integer","minimum":0.0,"title":"Articles"},"editions":{"type":"integer","minimum":0.0,"title":"Editions"},"sources":{"type":"integer","minimum":0.0,"title":"Sources"},"countries":{"type":"integer","minimum":0.0,"title":"Countries"},"figures":{"type":"integer","minimum":0.0,"title":"Figures","description":"Numeric metric values with a registered unit"},"data_articles":{"type":"integer","minimum":0.0,"title":"Data Articles"},"epc_articles":{"type":"integer","minimum":0.0,"title":"Epc Articles"}},"type":"object","required":["articles","editions","sources","countries","figures","data_articles","epc_articles"],"title":"ExploreTotals"},"ExploreView":{"properties":{"totals":{"$ref":"#/components/schemas/ExploreTotals"},"timeline":{"$ref":"#/components/schemas/ExploreTimeline"},"latest":{"items":{"$ref":"#/components/schemas/ExploreFigure"},"type":"array","title":"Latest"},"countries":{"items":{"$ref":"#/components/schemas/ExploreCount"},"type":"array","title":"Countries"},"sources":{"items":{"$ref":"#/components/schemas/ExploreCount"},"type":"array","title":"Sources"},"languages":{"items":{"$ref":"#/components/schemas/ExploreCount"},"type":"array","title":"Languages"},"dimensions":{"items":{"$ref":"#/components/schemas/ExploreCount"},"type":"array","title":"Dimensions"},"contracts":{"items":{"$ref":"#/components/schemas/ExploreFigure"},"type":"array","title":"Contracts"}},"type":"object","required":["totals","timeline"],"title":"ExploreView","description":"Counts of published stories and their stored figures; no inference, forecasting or conversion."},"ExploreWeek":{"properties":{"start":{"type":"string","title":"Start","description":"Monday of the ISO week, YYYY-MM-DD"},"count":{"type":"integer","minimum":0.0,"title":"Count"}},"type":"object","required":["start","count"],"title":"ExploreWeek"},"Geometry":{"properties":{"type":{"type":"string","enum":["Point","MultiPoint","LineString","MultiLineString","Polygon","MultiPolygon"],"title":"Type"},"coordinates":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"items":{"items":{"type":"number"},"type":"array"},"type":"array"},{"items":{"items":{"items":{"type":"number"},"type":"array"},"type":"array"},"type":"array"},{"items":{"items":{"items":{"items":{"type":"number"},"type":"array"},"type":"array"},"type":"array"},"type":"array"}],"title":"Coordinates"}},"additionalProperties":false,"type":"object","required":["type","coordinates"],"title":"Geometry","description":"Bounded 2D WGS84 GeoJSON; longitude precedes latitude."},"GlobalJobRequest":{"properties":{"stage":{"type":"string","enum":["signals","datasets"],"title":"Stage"},"article_id":{"type":"null","title":"Article Id"},"payload":{"additionalProperties":true,"type":"object","title":"Payload"}},"additionalProperties":false,"type":"object","required":["stage"],"title":"GlobalJobRequest"},"JobResponse":{"properties":{"id":{"type":"string","title":"Id"},"stage":{"type":"string","title":"Stage"},"status":{"type":"string","title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["id","stage","status","attempts"],"title":"JobResponse"},"Links":{"properties":{"self":{"type":"string","title":"Self"},"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next"},"previous":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous"}},"type":"object","required":["self"],"title":"Links"},"PageResponse":{"properties":{"kind":{"type":"string","title":"Kind"},"status":{"type":"integer","title":"Status","default":200},"redirect":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redirect"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"canonical":{"type":"string","title":"Canonical"},"robots":{"type":"string","title":"Robots"},"path":{"type":"string","title":"Path"},"page":{"type":"integer","title":"Page","default":1},"total":{"type":"integer","title":"Total","default":0},"total_pages":{"type":"integer","title":"Total Pages","default":1},"query":{"type":"string","title":"Query","default":""},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"taxonomy":{"anyOf":[{"$ref":"#/components/schemas/TaxonomyView"},{"type":"null"}]},"explore":{"anyOf":[{"$ref":"#/components/schemas/ExploreView"},{"type":"null"}]},"contracts":{"items":{"$ref":"#/components/schemas/ExploreFigure"},"type":"array","title":"Contracts","description":"Disclosed contract values on the EPC contractor topic page"},"article":{"anyOf":[{"$ref":"#/components/schemas/PublicArticle"},{"type":"null"}]},"articles":{"items":{"$ref":"#/components/schemas/StoryCard"},"type":"array","title":"Articles"},"related":{"items":{"$ref":"#/components/schemas/StoryCard"},"type":"array","title":"Related"},"links":{"anyOf":[{"$ref":"#/components/schemas/Links"},{"type":"null"}]},"alternates":{"additionalProperties":{"type":"string"},"type":"object","title":"Alternates"},"breadcrumbs":{"items":{"$ref":"#/components/schemas/Crumb"},"type":"array","title":"Breadcrumbs","description":"Visible trail from the edition home to this page; the last crumb is the page itself"},"schema_graph":{"additionalProperties":true,"type":"object","title":"Schema Graph"},"policy":{"items":{"type":"string"},"type":"array","title":"Policy"},"personalization":{"anyOf":[{"$ref":"#/components/schemas/Personalization"},{"type":"null"}]},"site":{"$ref":"#/components/schemas/PublicSite"},"coverage":{"$ref":"#/components/schemas/Coverage"}},"type":"object","required":["kind","language","title","description","canonical","robots","path","site","coverage"],"title":"PageResponse"},"Personalization":{"properties":{"personalized":{"type":"boolean","title":"Personalized","description":"The first page of the home is ordered by what this browser read; the edition's privacy page (/{lang}/privacy#reading) lists those reads and clears them"}},"type":"object","required":["personalized"],"title":"Personalization"},"PlaceAnnotation":{"properties":{"id":{"type":"string","maxLength":180,"minLength":1,"title":"Id"},"labels":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["tr","en","ar","fr","es","de","pt"]},"type":"object","title":"Labels"},"role":{"type":"string","enum":["coverage","event-location","source-mentioned-place","dataset-feature"],"title":"Role"},"kind":{"type":"string","enum":["country-or-area","region","administrative-area","city","site","other"],"title":"Kind"},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country"},"admin1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin1"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"geometry":{"anyOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"null"}]},"precision":{"type":"string","enum":["exact","approximate","regional","unspecified"],"title":"Precision","default":"unspecified"},"uncertainty_m":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Uncertainty M"},"match_status":{"type":"string","enum":["candidate","confirmed"],"title":"Match Status","default":"candidate"},"coordinate_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coordinate Source"},"coordinate_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coordinate Note"},"coordinate_reference_system":{"type":"string","const":"OGC:CRS84","title":"Coordinate Reference System","default":"OGC:CRS84"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","minItems":1,"title":"Evidence"}},"additionalProperties":false,"type":"object","required":["id","labels","role","kind","evidence"],"title":"PlaceAnnotation"},"PublicArticle":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"url":{"type":"string","title":"Url"},"api_url":{"type":"string","title":"Api Url"},"title":{"type":"string","title":"Title"},"summary":{"type":"string","title":"Summary"},"reading_minutes":{"type":"integer","minimum":1.0,"title":"Reading Minutes"},"category":{"type":"string","title":"Category"},"region":{"type":"string","title":"Region"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"annotation":{"anyOf":[{"$ref":"#/components/schemas/ArticleAnnotation"},{"type":"null"}]},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"event_id":{"type":"string","title":"Event Id"},"importance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Importance"},"published_at":{"type":"string","title":"Published At"},"modified_at":{"type":"string","title":"Modified At"},"publication_basis":{"type":"string","title":"Publication Basis"},"event_period":{"type":"string","title":"Event Period"},"event_period_basis":{"type":"string","title":"Event Period Basis"},"sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sources"},"translations":{"items":{"$ref":"#/components/schemas/TranslationLink"},"type":"array","title":"Translations"},"data_types":{"items":{"type":"string"},"type":"array","title":"Data Types"},"content":{"anyOf":[{"$ref":"#/components/schemas/Content"},{"type":"null"}]},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"corrections":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Corrections"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"data_downloads":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data Downloads"},"image":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Image"},"editorial_illustration":{"anyOf":[{"$ref":"#/components/schemas/EditorialIllustration"},{"type":"null"}]},"section_illustration":{"anyOf":[{"$ref":"#/components/schemas/EditorialIllustration"},{"type":"null"}]}},"type":"object","required":["id","slug","language","url","api_url","title","summary","reading_minutes","category","region","topics","event_id","published_at","modified_at","publication_basis","event_period","event_period_basis","sources","translations","data_types"],"title":"PublicArticle"},"PublicSite":{"properties":{"name":{"type":"string","title":"Name"},"publisher":{"$ref":"#/components/schemas/Publisher"},"categories":{"additionalProperties":{"additionalProperties":{"type":"string"},"type":"object"},"type":"object","title":"Categories"},"maps":{"additionalProperties":{"type":"string"},"type":"object","title":"Maps"},"languages":{"items":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"]},"type":"array","title":"Languages"}},"type":"object","required":["name","publisher","categories","maps","languages"],"title":"PublicSite"},"Publisher":{"properties":{"name":{"type":"string","title":"Name"},"editor":{"type":"string","title":"Editor"},"editor_slug":{"type":"string","pattern":"^[a-z0-9-]+$","title":"Editor Slug"},"email":{"type":"string","title":"Email"},"country":{"type":"string","pattern":"^[A-Z]{2}$","title":"Country"},"regions":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Regions"}},"type":"object","required":["name","editor","editor_slug","email","country","regions"],"title":"Publisher"},"ReadinessResponse":{"properties":{"status":{"type":"string","enum":["ok","degraded"],"title":"Status"},"checks":{"additionalProperties":{"type":"string","enum":["ok","unavailable","missing","behind"]},"type":"object","title":"Checks"}},"type":"object","required":["status","checks"],"title":"ReadinessResponse"},"StoryCard":{"properties":{"id":{"type":"string","title":"Id"},"slug":{"type":"string","title":"Slug"},"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"url":{"type":"string","title":"Url"},"title":{"type":"string","title":"Title"},"summary":{"type":"string","title":"Summary"},"reading_minutes":{"type":"integer","minimum":1.0,"title":"Reading Minutes"},"category":{"type":"string","title":"Category"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"published_at":{"type":"string","title":"Published At"},"sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sources"},"data_types":{"items":{"type":"string"},"type":"array","title":"Data Types"},"image":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Image"},"editorial_illustration":{"anyOf":[{"$ref":"#/components/schemas/EditorialIllustration"},{"type":"null"}]}},"type":"object","required":["id","slug","language","url","title","summary","reading_minutes","category","published_at","sources","data_types"],"title":"StoryCard","description":"A story as a listing shows it: the fields of `PublicArticle` that a card renders."},"SubjectLabel":{"properties":{"concept_id":{"type":"string","pattern":"^medtop:[0-9]{8}$","title":"Concept Id"},"status":{"type":"string","enum":["candidate","confirmed","rejected"],"title":"Status","default":"candidate"},"method":{"type":"string","title":"Method"},"rule_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rule Id"},"confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Confidence"},"confidence_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Method"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","minItems":1,"title":"Evidence"}},"additionalProperties":false,"type":"object","required":["concept_id","method","evidence"],"title":"SubjectLabel"},"SubjectView":{"properties":{"concept":{"$ref":"#/components/schemas/TaxonomyConcept"},"label":{"type":"string","title":"Label"},"label_language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Label Language"},"url":{"type":"string","title":"Url"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"paths":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Paths"}},"type":"object","required":["concept","label","label_language","url","count"],"title":"SubjectView"},"TaxonomyConcept":{"properties":{"id":{"type":"string","pattern":"^medtop:[0-9]{8}$","title":"Id"},"uri":{"type":"string","title":"Uri"},"slug":{"type":"string","maxLength":96,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Slug"},"status":{"type":"string","enum":["active","retired"],"title":"Status"},"created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created"},"modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modified"},"retired":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retired"},"broader_ids":{"items":{"type":"string"},"type":"array","title":"Broader Ids"},"labels":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["tr","en","ar","fr","es","de","pt"]},"type":"object","title":"Labels"},"definitions":{"additionalProperties":{"type":"string"},"type":"object","title":"Definitions"},"label_provenance":{"additionalProperties":true,"type":"object","title":"Label Provenance"}},"additionalProperties":false,"type":"object","required":["id","uri","slug","status","labels"],"title":"TaxonomyConcept"},"TaxonomyView":{"properties":{"revision":{"type":"string","title":"Revision"},"version":{"type":"string","title":"Version"},"subjects":{"items":{"$ref":"#/components/schemas/SubjectView"},"type":"array","title":"Subjects"},"article_subjects":{"items":{"$ref":"#/components/schemas/SubjectView"},"type":"array","title":"Article Subjects","description":"On a story page: every subject its annotation proposes, rejected ones included"},"selected":{"anyOf":[{"$ref":"#/components/schemas/SubjectView"},{"type":"null"}]},"children":{"items":{"$ref":"#/components/schemas/SubjectView"},"type":"array","title":"Children"},"breadcrumbs":{"items":{"items":{"$ref":"#/components/schemas/SubjectView"},"type":"array"},"type":"array","title":"Breadcrumbs"},"countries":{"items":{"$ref":"#/components/schemas/CountryFacet"},"type":"array","title":"Countries"},"annotation_status":{"type":"string","title":"Annotation Status","default":"candidate"},"filters":{"additionalProperties":{"type":"string"},"type":"object","title":"Filters"}},"type":"object","required":["revision","version","subjects"],"title":"TaxonomyView"},"TranslationLink":{"properties":{"language":{"type":"string","enum":["tr","en","ar","fr","es","de","pt"],"title":"Language"},"url":{"type":"string","title":"Url"},"api_url":{"type":"string","title":"Api Url"}},"type":"object","required":["language","url","api_url"],"title":"TranslationLink"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}