{ "openapi": "3.0.1", "info": { "title": "V-Dem Democracy Indices — Country-Year v16", "description": "Query any of the 288 V-Dem Country-Year Core v16 variables with codebook labels, confidence bounds, and dataset version metadata.", "version": "0.2", "x-build-id": "9tL9clHUWc02hx3U3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aitorsm~vdem-democracy-indices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aitorsm-vdem-democracy-indices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/aitorsm~vdem-democracy-indices/runs": { "post": { "operationId": "runs-sync-aitorsm-vdem-democracy-indices", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/aitorsm~vdem-democracy-indices/run-sync": { "post": { "operationId": "run-sync-aitorsm-vdem-democracy-indices", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "countries": { "title": "Countries", "type": "array", "description": "V-Dem country names or country_text_id codes, one per line. Use all by itself for every country. Unknown countries return an empty result.", "items": { "type": "string" } }, "indices": { "title": "Indices and variables", "uniqueItems": true, "type": "array", "description": "Pick one or more V-Dem variables. The five high-level democracy indices come first; the rest of the Core v16 catalogue (288 variables) follows, alphabetically by code.", "items": { "type": "string", "enum": [ "electoral", "liberal", "participatory", "deliberative", "egalitarian", "v2asuffrage", "v2caassemb", "v2cafexch", "v2cafres", "v2cainsaut", "v2casurv", "v2clacfree", "v2clacjstm", "v2clacjstw", "v2clacjust", "v2cldiscm", "v2cldiscw", "v2cldmovem", "v2cldmovew", "v2clfmove", "v2clgencl", "v2clgeocl", "v2clkill", "v2clpolcl", "v2clprptym", "v2clprptyw", "v2clrelig", "v2clrspct", "v2clslavef", "v2clslavem", "v2clsnlpct", "v2clsocgrp", "v2cltort", "v2cltrnslw", "v2cscnsult", "v2cseeorgs", "v2csgender", "v2csprtcpt", "v2csreprss", "v2csrlgrep", "v2ddadmci", "v2ddadmor", "v2ddadmpl", "v2ddadmrf", "v2ddappor", "v2ddapprci", "v2ddapprpl", "v2ddapprrf", "v2ddlexci", "v2ddlexor", "v2ddlexpl", "v2ddlexrf", "v2ddpartci", "v2ddpartor", "v2ddpartpl", "v2ddpartrf", "v2ddsigdci", "v2ddsigdrf", "v2ddsiglci", "v2ddsigpci", "v2ddsigprf", "v2ddspmci", "v2ddspmor", "v2ddspmpl", "v2ddspmrf", "v2ddthreci", "v2ddthreor", "v2ddthrepl", "v2ddthrerf", "v2ddyrci", "v2ddyror", "v2ddyrpl", "v2ddyrrf", "v2dlcommon", "v2dlconslt", "v2dlcountr", "v2dlencmps", "v2dlengage", "v2dlreason", "v2dlunivl", "v2edplural", "v2edpoledprim", "v2edpoledsec", "v2eldommon", "v2elembaut", "v2elembcap", "v2elfrfair", "v2elintim", "v2elintmon", "v2elirreg", "v2ellocelc", "v2ellocgov", "v2ellocpwr", "v2elmulpar", "v2elpeace", "v2elreggov", "v2elrgpwr", "v2elrgstry", "v2elrstrct", "v2elsrgel", "v2elsuffrage", "v2eltrnout", "v2eltype_0", "v2eltype_1", "v2eltype_4", "v2eltype_5", "v2eltype_6", "v2eltype_7", "v2elvaptrn", "v2elvotbuy", "v2ex_elechog", "v2ex_elechos", "v2ex_hogw", "v2ex_hosw", "v2ex_legconhos", "v2exaphogp", "v2exaphos", "v2exapup", "v2exapupap", "v2exbribe", "v2excrptps", "v2exdfcbhs", "v2exdfcbhs_rec", "v2exdfdmhs", "v2exdfdshg", "v2exdjcbhg", "v2exembez", "v2exhoshog", "v2expathhg", "v2expathhs", "v2exremhog", "v2exrescon", "v2exrmhgnp_2", "v2exrmhgnp_3", "v2exrmhgnp_4", "v2exrmhgnp_nr", "v2exrmhsol_2", "v2exrmhsol_3", "v2exrmhsol_4", "v2exrmhsol_nr", "v2exthftps", "v2juaccnt", "v2jucomp", "v2jucorrdc", "v2juhccomp", "v2juhcind", "v2juncind", "v2lgbicam", "v2lgcrrpt", "v2lgelecup", "v2lgello", "v2lgfemleg", "v2lgfunds", "v2lginello", "v2lginelup", "v2lginvstp", "v2lgoppart", "v2lgotovst", "v2lgqstexp", "v2mebias", "v2mecenefi", "v2mecenefm", "v2mecrit", "v2mefemjrn", "v2meharjrn", "v2merange", "v2meslfcen", "v2peapsecon", "v2peapsgen", "v2peapsgeo", "v2peapspol", "v2peapssoc", "v2peasbecon", "v2peasbegeo", "v2peasbepol", "v2peasbgen", "v2peasbsoc", "v2peasjgen", "v2peasjgeo", "v2peasjpol", "v2peasjsoc", "v2peasjsoecon", "v2peedueq", "v2pehealth", "v2pepwrgen", "v2pepwrgeo", "v2pepwrort", "v2pepwrses", "v2pepwrsoc", "v2psbars", "v2pscnslnl", "v2pscohesv", "v2psnatpar", "v2psoppaut", "v2psorgs", "v2psparban", "v2psplats", "v2psprbrch", "v2psprlnks", "v2smpardom", "v2x_EDcomp_thick", "v2x_accountability", "v2x_api", "v2x_civlib", "v2x_clphy", "v2x_clpol", "v2x_clpriv", "v2x_corr", "v2x_cspart", "v2x_delibdem_stock", "v2x_diagacc", "v2x_divparctrl", "v2x_egal", "v2x_egaldem_stock", "v2x_elecoff", "v2x_elecreg", "v2x_electoral_integrity", "v2x_ex_confidence", "v2x_ex_direlect", "v2x_ex_hereditary", "v2x_ex_military", "v2x_ex_party", "v2x_execorr", "v2x_feduni", "v2x_frassoc_thick", "v2x_freexp", "v2x_freexp_altinf", "v2x_gencl", "v2x_gencs", "v2x_gender", "v2x_genpp", "v2x_horacc", "v2x_hosabort", "v2x_hosinter", "v2x_jucon", "v2x_legabort", "v2x_libdem_stock", "v2x_liberal", "v2x_mpi", "v2x_neopat", "v2x_partip", "v2x_partipdem_stock", "v2x_polyarchy_stock", "v2x_pubcorr", "v2x_regime", "v2x_regime_amb", "v2x_rule", "v2x_suffr", "v2x_veracc", "v2xca_academ", "v2xcl_acjst", "v2xcl_disc", "v2xcl_dmove", "v2xcl_prpty", "v2xcl_rol", "v2xcl_slave", "v2xcs_ccsi", "v2xdd_cic", "v2xdd_dd", "v2xdd_i_ci", "v2xdd_i_or", "v2xdd_i_pl", "v2xdd_i_rf", "v2xdd_toc", "v2xdl_delib", "v2xeg_eqaccess", "v2xeg_eqdr", "v2xeg_eqprotec", "v2xel_elecparl", "v2xel_elecpres", "v2xel_frefair", "v2xel_locelec", "v2xel_regelec", "v2xex_elecleg", "v2xex_elecreg", "v2xlg_elecreg", "v2xlg_legcon", "v2xlg_leginter", "v2xme_altinf", "v2xnp_client", "v2xnp_pres", "v2xnp_regcorr", "v2xpe_exlecon", "v2xpe_exlgender", "v2xpe_exlgeo", "v2xpe_exlpol", "v2xpe_exlsocgr", "v2xps_party" ], "enumTitles": [ "Electoral democracy index (v2x_polyarchy)", "Liberal democracy index (v2x_libdem)", "Participatory democracy index (v2x_partipdem)", "Deliberative democracy index (v2x_delibdem)", "Egalitarian democracy index (v2x_egaldem)", "Suffrage (v2asuffrage)", "Freedom of peaceful assembly (v2caassemb)", "Freedom of academic exchange and dissemination (v2cafexch)", "Freedom to research and teach (v2cafres)", "Institutional autonomy (v2cainsaut)", "Campus integrity (v2casurv)", "Freedom of academic and cultural expression (v2clacfree)", "Access to justice for men (v2clacjstm)", "Access to justice for women (v2clacjstw)", "Social class equality in respect for civil liberty (v2clacjust)", "Freedom of discussion for men (v2cldiscm)", "Freedom of discussion for women (v2cldiscw)", "Freedom of domestic movement for men (v2cldmovem)", "Freedom of domestic movement for women (v2cldmovew)", "Freedom of foreign movement (v2clfmove)", "Gender equality in respect for civil liberties (v2clgencl)", "Urban-rural location equality in respect for civil liberties (v2clgeocl)", "Freedom from political killings (v2clkill)", "Political group equality in respect for civil liberties (v2clpolcl)", "Property rights for men (v2clprptym)", "Property rights for women (v2clprptyw)", "Freedom of religion (v2clrelig)", "Rigorous and impartial public administration (v2clrspct)", "Freedom from forced labor for women (v2clslavef)", "Freedom from forced labor for men (v2clslavem)", "Weaker civil liberties population (v2clsnlpct)", "Social group equality in respect for civil liberties (v2clsocgrp)", "Freedom from torture (v2cltort)", "Transparent laws with predictable enforcement (v2cltrnslw)", "CSO consultation (v2cscnsult)", "CSO entry and exit (v2cseeorgs)", "CSO women’s participation (v2csgender)", "CSO participatory environment (v2csprtcpt)", "CSO repression (v2csreprss)", "Religious organization repression (v2csrlgrep)", "Initiatives administrative threshold (v2ddadmci)", "Obligatory referendum administrative threshold (v2ddadmor)", "Plebiscites administrative threshold (v2ddadmpl)", "Referendums administrative threshold (v2ddadmrf)", "Obligatory referendum approval threshold (v2ddappor)", "Initiatives approval threshold (v2ddapprci)", "Plebiscites approval threshold (v2ddapprpl)", "Referendums approval threshold (v2ddapprrf)", "Initiatives permitted (v2ddlexci)", "Enforcement of Constitutional changes through popular vote (v2ddlexor)", "Plebiscites permitted (v2ddlexpl)", "Referendums permitted (v2ddlexrf)", "Initiatives participation threshold (v2ddpartci)", "Obligatory referendum participation threshold (v2ddpartor)", "Plebiscites participation threshold (v2ddpartpl)", "Referendums participation threshold (v2ddpartrf)", "Initiatives signature-gathering period (v2ddsigdci)", "Referendums signature-gathering period (v2ddsigdrf)", "Initiatives signature-gathering time limit (v2ddsiglci)", "Initiatives signatures % (v2ddsigpci)", "Referendums signatures % (v2ddsigprf)", "Initiatives super majority (v2ddspmci)", "Obligatory referendum super majority (v2ddspmor)", "Plebiscites super majority (v2ddspmpl)", "Referendums super majority (v2ddspmrf)", "Popular initiative credible threat (v2ddthreci)", "Obligatory referendum credible threat (v2ddthreor)", "Plebiscites credible threat (v2ddthrepl)", "Popular referendum credible threat (v2ddthrerf)", "Occurrence of citizen-initiatives this year (v2ddyrci)", "Occurrence of obligatory referendum this year (v2ddyror)", "Occurrence of plebiscite this year (v2ddyrpl)", "Occurrence of referendum this year (v2ddyrrf)", "Common good (v2dlcommon)", "Range of consultation (v2dlconslt)", "Respect counterarguments (v2dlcountr)", "Particularistic or public goods (v2dlencmps)", "Engaged society (v2dlengage)", "Reasoned justification (v2dlreason)", "Means-tested v. universalistic policy (v2dlunivl)", "Pluralism in the curriculum (v2edplural)", "Political education, primary school (v2edpoledprim)", "Political education, secondary school (v2edpoledsec)", "Election domestic election monitors (v2eldommon)", "EMB autonomy (v2elembaut)", "EMB capacity (v2elembcap)", "Election free and fair (v2elfrfair)", "Election government intimidation (v2elintim)", "Election international monitors (v2elintmon)", "Election other voting irregularities (v2elirreg)", "Local government elected (v2ellocelc)", "Local government exists (v2ellocgov)", "Local offices relative power (v2ellocpwr)", "Elections multiparty (v2elmulpar)", "Election other electoral violence (v2elpeace)", "Regional government exists (v2elreggov)", "Regional offices relative power (v2elrgpwr)", "Election voter registry (v2elrgstry)", "Candidate restriction by ethnicity, race, religion, or language (v2elrstrct)", "Regional government elected (v2elsrgel)", "Percentage of population with suffrage (v2elsuffrage)", "Election turnout (v2eltrnout)", "Election type: Legislative; lower, sole, or both chambers, first or only round (v2eltype_0)", "Election type: Legislative, lower, sole, or both chambers, second round (v2eltype_1)", "Election type: Constituent Assembly, first or only round (v2eltype_4)", "Election type: Constituent Assembly, second round (v2eltype_5)", "Election type: Presidential, first or only round (v2eltype_6)", "Election type: Presidential, second round (v2eltype_7)", "Election VAP turnout (v2elvaptrn)", "Election vote buying (v2elvotbuy)", "HOG directly elected (v2ex_elechog)", "HOS directly elected (v2ex_elechos)", "Relative power of the HOG (v2ex_hogw)", "Relative power of the HOS (v2ex_hosw)", "HOS appointed by legislature (v2ex_legconhos)", "HOG selection by legislature in practice (v2exaphogp)", "HOS selection by legislature in practice (v2exaphos)", "Chief executive appointment by upper chamber (v2exapup)", "Chief executive appointment by upper chamber implicit approval (v2exapupap)", "Executive bribery and corrupt exchanges (v2exbribe)", "Public sector corrupt exchanges (v2excrptps)", "HOS appoints cabinet in practice (v2exdfcbhs)", "HOS appoints cabinet in practice (v2exdfcbhs_rec)", "HOS dismisses ministers in practice (v2exdfdmhs)", "HOG dismisses ministers in practice (v2exdfdshg)", "HOG appoints cabinet in practice (v2exdjcbhg)", "Executive embezzlement and theft (v2exembez)", "HOS = HOG (v2exhoshog)", "HOG appointment in practice (v2expathhg)", "HOS appointment in practice (v2expathhs)", "HOG removal by legislature in practice (v2exremhog)", "Executive respects constitution (v2exrescon)", "HOG removal by other in practice: The ruling party or party leadership body (in a one-party system) (v2exrmhgnp_2)", "HOG removal by other in practice: A royal council (v2exrmhgnp_3)", "HOG removal by other in practice: The military (v2exrmhgnp_4)", "HOG removal by other in practice (number of coders, *_nr) (v2exrmhgnp_nr)", "HOS removal by other in practice: The ruling party or party leadership body (in a one-party system) (v2exrmhsol_2)", "HOS removal by other in practice: A royal council (v2exrmhsol_3)", "HOS removal by other in practice: The military (v2exrmhsol_4)", "HOS removal by other in practice (number of coders, *_nr) (v2exrmhsol_nr)", "Public sector theft (v2exthftps)", "Judicial accountability (v2juaccnt)", "Compliance with judiciary (v2jucomp)", "Judicial corruption decision (v2jucorrdc)", "Compliance with high court (v2juhccomp)", "High court independence (v2juhcind)", "Lower court independence (v2juncind)", "Legislature bicameral (v2lgbicam)", "Legislature corrupt activities (v2lgcrrpt)", "Upper chamber elected (v2lgelecup)", "Lower chamber elected (v2lgello)", "Lower chamber female legislators (v2lgfemleg)", "Legislature controls resources (v2lgfunds)", "Percentage of indirectly elected legislators lower chamber (v2lginello)", "Percentage of indirectly elected legislators upper chamber (v2lginelup)", "Legislature investigates in practice (v2lginvstp)", "Legislature opposition parties (v2lgoppart)", "Executive oversight (v2lgotovst)", "Legislature questions officials in practice (v2lgqstexp)", "Media bias (v2mebias)", "Internet censorship effort (v2mecenefi)", "Government censorship effort — Media (v2mecenefm)", "Print/broadcast media critical (v2mecrit)", "Female journalists (v2mefemjrn)", "Harassment of journalists (v2meharjrn)", "Print/broadcast media perspectives (v2merange)", "Media self-censorship (v2meslfcen)", "Access to public services distributed by socio-economic position (v2peapsecon)", "Access to public services distributed by gender (v2peapsgen)", "Access to public services distributed by urban-rural location (v2peapsgeo)", "Access to public services distributed by political group (v2peapspol)", "Access to public services distributed by social group (v2peapssoc)", "Access to state business opportunities by socio-economic position (v2peasbecon)", "Access to state business opportunities by urban-rural location (v2peasbegeo)", "Access to state business opportunities by political group (v2peasbepol)", "Access to state business opportunities by gender (v2peasbgen)", "Access to state business opportunities by social group (v2peasbsoc)", "Access to state jobs by gender (v2peasjgen)", "Access to state jobs by urban-rural location (v2peasjgeo)", "Access to state jobs by political group (v2peasjpol)", "Access to state jobs by social group (v2peasjsoc)", "Access to state jobs by socio-economic position (v2peasjsoecon)", "Educational equality (v2peedueq)", "Health equality (v2pehealth)", "Power distributed by gender (v2pepwrgen)", "Power distributed by urban-rural location (v2pepwrgeo)", "Power distributed by sexual orientation (v2pepwrort)", "Power distributed by socioeconomic position (v2pepwrses)", "Power distributed by social group (v2pepwrsoc)", "Barriers to parties (v2psbars)", "Candidate selection-national/local (v2pscnslnl)", "Legislative party cohesion (v2pscohesv)", "National party control (v2psnatpar)", "Opposition parties autonomy (v2psoppaut)", "Party organizations (v2psorgs)", "Party ban (v2psparban)", "Distinct party platforms (v2psplats)", "Party branches (v2psprbrch)", "Party linkages (v2psprlnks)", "Party dissemination of false information domestic (v2smpardom)", "Electoral component index (v2x_EDcomp_thick)", "Accountability index (v2x_accountability)", "Additive polyarchy index (v2x_api)", "Civil liberties index (v2x_civlib)", "Physical violence index (v2x_clphy)", "Political civil liberties index (v2x_clpol)", "Private civil liberties index (v2x_clpriv)", "Political corruption index (v2x_corr)", "Civil society participation index (v2x_cspart)", "Deliberative Democracy Stock (v2x_delibdem_stock)", "Diagonal accountability index (v2x_diagacc)", "Divided party control index (v2x_divparctrl)", "Egalitarian component index (v2x_egal)", "Egalitarian Democracy Stock (v2x_egaldem_stock)", "Elected officials index (v2x_elecoff)", "Electoral regime index (v2x_elecreg)", "Electoral Integrity Index (v2x_electoral_integrity)", "Confidence dimension index (v2x_ex_confidence)", "Direct election dimension index (v2x_ex_direlect)", "Hereditary dimension index (v2x_ex_hereditary)", "Military dimension index (v2x_ex_military)", "Ruling party dimension index (v2x_ex_party)", "Executive corruption index (v2x_execorr)", "Division of power index (v2x_feduni)", "Freedom of association thick index (v2x_frassoc_thick)", "Freedom of expression index (v2x_freexp)", "Freedom of Expression and Alternative Sources of Information index (v2x_freexp_altinf)", "Women civil liberties index (v2x_gencl)", "Women civil society participation index (v2x_gencs)", "Women political empowerment index (v2x_gender)", "Women political participation index (v2x_genpp)", "Horizontal accountability index (v2x_horacc)", "Presidential election aborted (v2x_hosabort)", "Chief executive no longer elected (v2x_hosinter)", "Judicial constraints on the executive index (v2x_jucon)", "Legislative or constituent assembly election aborted (v2x_legabort)", "Liberal Democracy Stock (v2x_libdem_stock)", "Liberal component index (v2x_liberal)", "Multiplicative polyarchy index (v2x_mpi)", "Neopatrimonial Rule Index (v2x_neopat)", "Participatory component index (v2x_partip)", "Participatory Democracy Stock (v2x_partipdem_stock)", "Electoral Democracy Stock (v2x_polyarchy_stock)", "Public sector corruption index (v2x_pubcorr)", "Regimes of the world – the RoW measure (v2x_regime)", "Regimes of the world – the RoW measure with categories for ambiguous cases (v2x_regime_amb)", "Rule of law index (v2x_rule)", "Share of population with suffrage (v2x_suffr)", "Vertical accountability index (v2x_veracc)", "Academic Freedom Index (v2xca_academ)", "Access to justice (v2xcl_acjst)", "Freedom of discussion (v2xcl_disc)", "Freedom of domestic movement (v2xcl_dmove)", "Property rights (v2xcl_prpty)", "Equality before the law and individual liberty index (v2xcl_rol)", "Freedom from forced labor (v2xcl_slave)", "Core civil society index (v2xcs_ccsi)", "Citizen-initiated component of direct popular vote index (v2xdd_cic)", "Direct popular vote index (v2xdd_dd)", "Popular initiative index (v2xdd_i_ci)", "Obligatory referendum index (v2xdd_i_or)", "Plebiscite index (v2xdd_i_pl)", "Popular referendum index (v2xdd_i_rf)", "Top-Down component of direct popular vote index (v2xdd_toc)", "Deliberative component index (v2xdl_delib)", "Equal access index (v2xeg_eqaccess)", "Equal distribution of resources index (v2xeg_eqdr)", "Equal protection index (v2xeg_eqprotec)", "Legislative or constituent assembly election (v2xel_elecparl)", "Presidential election (v2xel_elecpres)", "Clean elections index (v2xel_frefair)", "Local government index (v2xel_locelec)", "Regional government index (v2xel_regelec)", "Legislature directly elected (v2xex_elecleg)", "Executive electoral regime index (v2xex_elecreg)", "Legislative electoral regime index (v2xlg_elecreg)", "Legislative constraints on the executive index (v2xlg_legcon)", "Legislature closed down or aborted (v2xlg_leginter)", "Alternative sources of information index (v2xme_altinf)", "Clientelism Index (v2xnp_client)", "Presidentialism Index (v2xnp_pres)", "Regime corruption (v2xnp_regcorr)", "Exclusion by Socio-Economic Group (v2xpe_exlecon)", "Exclusion by Gender index (v2xpe_exlgender)", "Exclusion by Urban-Rural Location index (v2xpe_exlgeo)", "Exclusion by Political Group index (v2xpe_exlpol)", "Exclusion by Social Group index (v2xpe_exlsocgr)", "Party institutionalization index (v2xps_party)" ] } }, "startYear": { "title": "First year", "minimum": 1789, "maximum": 2025, "type": "integer", "description": "First country-year to include, from 1789 through 2025.", "default": 2024 }, "endYear": { "title": "Last year", "minimum": 1789, "maximum": 2025, "type": "integer", "description": "Last country-year to include, from the first year through 2025. Defaults to the first year." }, "maxRows": { "title": "Maximum rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many rows. Batch runs allow 1 to 10,000 rows.", "default": 10000 }, "listVariables": { "title": "List variables (free)", "type": "boolean", "description": "Return the variable catalogue (name, codebook label, section, bounds, and year/country coverage) in the VARIABLES key-value record instead of data rows. No dataset items are pushed, so only the Actor start is charged.", "default": false }, "search": { "title": "Variable search", "type": "string", "description": "With List variables: keep only variables whose name, label, or section contain every keyword, for example corruption." }, "refreshSource": { "title": "Refresh the data", "type": "boolean", "description": "Reload the v16 data and replace the cached snapshot before querying. This can be slow; false uses the bundled, dated v16 snapshot.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }