{
  "openapi": "3.0.1",
  "info": {
    "title": "Our World in Data Chart & Article Extractor",
    "description": "Browse Our World in Data articles by topic or keyword, download the dataset behind any chart by its slug, or pull country profile pages, with article, chart, and data-row records.",
    "version": "2.0",
    "x-build-id": "otRcer49ceMIc3esl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~our-world-in-data-chart-and-article-extractor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-our-world-in-data-chart-and-article-extractor",
        "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/nimbryxo-studio~our-world-in-data-chart-and-article-extractor/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-our-world-in-data-chart-and-article-extractor",
        "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/nimbryxo-studio~our-world-in-data-chart-and-article-extractor/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-our-world-in-data-chart-and-article-extractor",
        "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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "articles",
              "chartCatalog",
              "chartData",
              "chartDataBulk",
              "countries"
            ],
            "type": "string",
            "description": "Choose what to collect.",
            "default": "articles"
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Keyword search. Used by articles mode and chart catalog mode, and as a country-name search in countries mode when no country list is set."
          },
          "topic": {
            "title": "Topic",
            "enum": [
              "",
              "Access to Energy",
              "Age Structure",
              "Agricultural Production",
              "Air Pollution",
              "Alcohol Consumption",
              "Animal Welfare",
              "Antibiotics & Antibiotic Resistance",
              "Artificial Intelligence",
              "Biodiversity",
              "Bioenergy and Biofuels",
              "Books",
              "Burden of Disease",
              "CO2 & Greenhouse Gas Emissions",
              "COVID-19",
              "Cancer",
              "Cardiovascular Diseases",
              "Causes of Death",
              "Child & Infant Mortality",
              "Child Labor",
              "Clean Water",
              "Clean Water & Sanitation",
              "Climate Change",
              "Corruption",
              "Crime",
              "Crop Yields",
              "Democracy",
              "Diarrheal Diseases",
              "Diet Compositions",
              "Economic Growth",
              "Economic Inequality",
              "Economic Inequality by Gender",
              "Education Spending",
              "Education and Knowledge",
              "Electricity Mix",
              "Employment in Agriculture",
              "Energy",
              "Energy Mix",
              "Energy and Environment",
              "Environmental Impacts of Food Production",
              "Eradication of Diseases",
              "Famines",
              "Farm Size",
              "Fertility Rate",
              "Fertilizers",
              "Fish & Overfishing",
              "Food Prices",
              "Food Supply",
              "Food and Agriculture",
              "Foreign Aid",
              "Forests & Deforestation",
              "Fossil Fuels",
              "Gender Ratio",
              "Global Education",
              "Global Health",
              "Government Spending",
              "HIV/AIDS",
              "Happiness & Life Satisfaction",
              "Health",
              "Healthcare Spending",
              "Homelessness",
              "Homicides",
              "Human Development Index (HDI)",
              "Human Height",
              "Human Rights",
              "Human Rights and Democracy",
              "Hunger & Undernourishment",
              "Illicit Drug Use",
              "Indoor Air Pollution",
              "Influenza",
              "Innovation and Technological Change",
              "Internet",
              "LGBT+ Rights",
              "Land Use",
              "Lead Pollution",
              "Life Expectancy",
              "Light at Night",
              "Literacy",
              "Living Conditions, Community and Wellbeing",
              "Loneliness & Social Connections",
              "Malaria",
              "Marriages & Divorces",
              "Maternal Mortality",
              "Meat & Dairy Production",
              "Medicine & Biotechnology",
              "Mental Health",
              "Metals & Minerals",
              "Micronutrient Deficiency",
              "Migration",
              "Military Personnel & Spending",
              "Mpox (monkeypox)",
              "Natural Disasters",
              "Neglected Tropical Diseases",
              "Nuclear Energy",
              "Nuclear Weapons",
              "Obesity",
              "Oil Spills",
              "Outdoor Air Pollution",
              "Ozone Layer",
              "Pandemics",
              "Pesticides",
              "Plastic Pollution",
              "Pneumonia",
              "Polio",
              "Population Growth",
              "Population and Demographic Change",
              "Poverty",
              "Poverty and Economic Development",
              "Religion",
              "Renewable Energy",
              "Research & Development",
              "Sanitation",
              "Sexual & Reproductive Health",
              "Smallpox",
              "Smoking",
              "Space Exploration & Satellites",
              "State Capacity",
              "Suicides",
              "Taxation",
              "Technological Change",
              "Terrorism",
              "Tetanus",
              "Time Use",
              "Tourism",
              "Trade & Globalization",
              "Transport",
              "Trust",
              "Tuberculosis",
              "Unemployment",
              "Urbanization",
              "Vaccination",
              "Violence Against Children & Children's Rights",
              "Violence and War",
              "War & Peace",
              "Waste Management",
              "Water Use & Stress",
              "Wildfires",
              "Women's Employment",
              "Women's Rights",
              "Work & Employment",
              "Working Hours",
              "poverty",
              "health",
              "population-growth",
              "education",
              "food-agriculture",
              "climate-change",
              "energy",
              "violence-war",
              "political-systems",
              "economy",
              "environment",
              "urbanization",
              "water-sanitation",
              "technology",
              "human-rights",
              "co2-greenhouse-gas-emissions",
              "life-expectancy",
              "child-mortality",
              "global-health",
              "global-inequalities"
            ],
            "type": "string",
            "description": "Restrict articles (and chart catalog results) to one OWID topic tag.",
            "default": ""
          },
          "author": {
            "title": "Author",
            "enum": [
              "",
              "Angela Wenham",
              "Bastian Herre",
              "Bernadeta Dadonaite",
              "Bertha Rohenkohl",
              "Bobbie Macdonald",
              "Cameron Appel",
              "Charlie Giattino",
              "Christian Swinehart",
              "Daniel Bachler",
              "Daniel Gavrilov",
              "Diana Beltekian",
              "Dr. Jill Gordon (guest author)",
              "Edouard Mathieu",
              "Ernst van Woerden",
              "Esteban Ortiz-Ospina",
              "Fiona Spooner",
              "Guest Authors",
              "Hannah Behrens",
              "Hannah Ritchie",
              "Ike Saunders",
              "Jaiden Mispy",
              "Janine Aron",
              "Joe Hasell",
              "John Muellbauer",
              "Lars Yencken",
              "Lucas Rodés-Guirao",
              "Marcel Gerber",
              "Martin Račák",
              "Marwa Boukarim",
              "Matt Munday",
              "Matthew Cone (guest author)",
              "Matthew Conlen",
              "Matthieu Bergel",
              "Max Roser",
              "Mojmir Vinkler",
              "Nicolas Lippolis",
              "Our World in Data team",
              "Pablo Arriagada",
              "Pablo Rosado",
              "Saloni Dattani",
              "Samantha Vanderslott",
              "Sandra Tzvetkova",
              "Simon van Teutem",
              "Sophia Mersmann",
              "Sophie Ochmann",
              "Tatjana Marks",
              "Tuna Acisu",
              "Veronika Samborska"
            ],
            "type": "string",
            "description": "Restrict articles to one OWID author.",
            "default": ""
          },
          "articleType": {
            "title": "Page type",
            "enum": [
              "editorial",
              "article",
              "data-insight",
              "announcement",
              "topic-page",
              "linear-topic-page",
              "about-page",
              "featured-viz",
              "profile",
              "all"
            ],
            "type": "string",
            "description": "Which page types articles mode may return. 'Editorial' covers articles, data insights, announcements and topic pages; 'All' also includes profiles and featured visualizations.",
            "default": "editorial"
          },
          "sortBy": {
            "title": "Sort articles by",
            "enum": [
              "newest",
              "oldest",
              "relevance"
            ],
            "type": "string",
            "description": "Order of article records.",
            "default": "newest"
          },
          "dateFrom": {
            "title": "Published from",
            "type": "string",
            "description": "Only articles published on or after this date (YYYY-MM-DD)."
          },
          "dateTo": {
            "title": "Published to",
            "type": "string",
            "description": "Only articles published on or before this date (YYYY-MM-DD)."
          },
          "includeContent": {
            "title": "Include full article text",
            "type": "boolean",
            "description": "Add OWID's full text to each article record (larger output).",
            "default": false
          },
          "includeArticleDetails": {
            "title": "Enrich articles from their pages",
            "type": "boolean",
            "description": "Visit each selected article page to fill related charts and any missing page metadata. Slower; off by default.",
            "default": false
          },
          "chartSlug": {
            "title": "Chart slug or URL",
            "type": "string",
            "description": "A Grapher slug or full URL, e.g. 'life-expectancy' or the URL of that chart."
          },
          "chartSlugs": {
            "title": "Chart slugs or URLs (bulk)",
            "type": "array",
            "description": "Several chart slugs/URLs for chartDataBulk mode.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "entities": {
            "title": "Countries or regions",
            "type": "array",
            "description": "Keep chart data rows for these entities only. Names ('Germany'), OWID/ISO codes ('DEU'), two-letter codes ('DE') and slugs all work. Empty means all entities.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "columns": {
            "title": "Data columns",
            "type": "array",
            "description": "Keep only these data columns. Match by CSV header, short name, titleLong, display title or OWID variable ID. Empty means every column.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "yearFrom": {
            "title": "Year from",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest year to keep in chart data rows."
          },
          "yearTo": {
            "title": "Year to",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest year to keep in chart data rows."
          },
          "dataFormat": {
            "title": "Chart data shape",
            "enum": [
              "wide",
              "long"
            ],
            "type": "string",
            "description": "'Wide' keeps one record per entity-year with one field per data column. 'Long' emits one record per entity-year-column with column, value and unit fields.",
            "default": "wide"
          },
          "includeChartConfig": {
            "title": "Include chart metadata record",
            "type": "boolean",
            "description": "Emit the chart's title, citation, units, column details and source URLs before its rows.",
            "default": true
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Countries mode: names, slugs or ISO codes. Empty means all listed countries, or the searchQuery country match.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxIndicatorsPerCountry": {
            "title": "Max indicators per country",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many chart indicators to list inside each country record, up to 5,000.",
            "default": 100
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 25000,
            "type": "integer",
            "description": "Hard cap on emitted records, up to 25,000.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}