{"openapi":"3.0.3","info":{"title":"BPC Research Public & Consumer API","version":"1.0.0","description":"Official REST API for BPC Research (Public Opinion & Market Research Center). Provides programmatical access to national polls, longitudinal barometers, cross-tabulations, and dataset downloads in JSON & CSV.","contact":{"name":"BPC Research Data Desk","email":"info@bpcresearch.ge","url":"https://bpcresearch.ge"},"license":{"name":"Creative Commons Attribution 4.0 International (CC BY 4.0)","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://bpc-research-blue.vercel.app/api/v1","description":"Production API"},{"url":"http://localhost:3000/api/v1","description":"Local Development"}],"paths":{"/research":{"get":{"summary":"List published research studies","parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ka","en"],"default":"ka"}}],"responses":{"200":{"description":"Successful response"}}}},"/research/{slug}":{"get":{"summary":"Get single study details, questions, and citations","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ka","en"],"default":"ka"}}],"responses":{"200":{"description":"Study details"},"404":{"description":"Not found"}}}},"/data":{"get":{"summary":"Get list of indicators, barometer waves, and available questions","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["ka","en"],"default":"ka"}}],"responses":{"200":{"description":"Indicators list"}}}},"/data/{id}":{"get":{"summary":"Download question microdata or indicator series in JSON or CSV","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv"],"default":"json"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ka","en"],"default":"ka"}}],"responses":{"200":{"description":"Question data or CSV stream"}}}},"/media":{"get":{"summary":"List press releases, analytical briefs, and media appearances","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["press-release","brief","op-ed","media-coverage"]}},{"name":"lang","in":"query","schema":{"type":"string","enum":["ka","en"],"default":"ka"}}],"responses":{"200":{"description":"Press items list"}}}},"/order":{"post":{"summary":"Submit a custom research project inquiry","responses":{"200":{"description":"Inquiry registered"},"400":{"description":"Validation error"}}}},"/contact":{"post":{"summary":"Submit a general or media inquiry","responses":{"200":{"description":"Message received"},"400":{"description":"Validation error"}}}}}}