{
  "openapi": "3.0.1",
  "info": {
    "title": "OEC Economic Complexity Trade Scraper",
    "description": "Scrape Observatory of Economic Complexity (OEC) bilateral trade flows: country, partner, product (HS code), year, export value, import value, and economic complexity index. Export international trade data to JSON, CSV, or Excel for economics research, supply chain, and market intel.",
    "version": "1.0",
    "x-build-id": "x610mONerdGNBBTI1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~oec-economic-complexity-trade-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-oec-economic-complexity-trade-scraper",
        "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/parseforge~oec-economic-complexity-trade-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-oec-economic-complexity-trade-scraper",
        "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/parseforge~oec-economic-complexity-trade-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-oec-economic-complexity-trade-scraper",
        "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": {
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
          },
          "year": {
            "title": "Year",
            "minimum": 1962,
            "maximum": 2024,
            "type": "integer",
            "description": "Year of trade data (BACI HS6: 1995-2024; SITC: 1962-2022)."
          },
          "reporter": {
            "title": "Reporter (exporter country)",
            "enum": [
              "",
              "afago",
              "afbdi",
              "afben",
              "afbfa",
              "afbwa",
              "afcaf",
              "afciv",
              "afcmr",
              "afcod",
              "afcog",
              "afcom",
              "afcpv",
              "afdji",
              "afdza",
              "afegy",
              "aferi",
              "afeth",
              "afgab",
              "afgha",
              "afgin",
              "afgmb",
              "afgnb",
              "afgnq",
              "afken",
              "aflbr",
              "aflby",
              "aflso",
              "afmar",
              "afmdg",
              "afmli",
              "afmoz",
              "afmrt",
              "afmus",
              "afmwi",
              "afmyt",
              "afnam",
              "afner",
              "afnga",
              "afrwa",
              "afsdn",
              "afsen",
              "afshn",
              "afsle",
              "afsom",
              "afssd",
              "afstp",
              "afswz",
              "afsyc",
              "aftcd",
              "aftgo",
              "aftun",
              "aftza",
              "afuga",
              "afzaf",
              "afzmb",
              "afzwe",
              "asafg",
              "asare",
              "asarm",
              "asaze",
              "asbgd",
              "asbhr",
              "asbrn",
              "asbtn",
              "ascck",
              "aschn",
              "ascxr",
              "ascyp",
              "asgeo",
              "ashkg",
              "asidn",
              "asind",
              "asiot",
              "asirn",
              "asirq",
              "asisr",
              "asjor",
              "asjpn",
              "askaz",
              "askgz",
              "askhm",
              "askor",
              "askwt",
              "aslao",
              "aslbn",
              "aslka",
              "asmac",
              "asmdv",
              "asmmr",
              "asmng",
              "asmys",
              "asnpl",
              "asomn",
              "aspak",
              "asphl",
              "asprk",
              "aspse",
              "asqat",
              "assau",
              "assgp",
              "assyr",
              "astha",
              "astjk",
              "astkm",
              "astls",
              "astur",
              "astwn",
              "asuzb",
              "asvnm",
              "asyem",
              "eualb",
              "euand",
              "euaut",
              "eubel",
              "eubgr",
              "eubih",
              "eublr",
              "eublx",
              "euche",
              "eucze",
              "eudeu",
              "eudnk",
              "euesp",
              "euest",
              "eufin",
              "eufra",
              "eugbr",
              "eugib",
              "eugrc",
              "euhrv",
              "euhun",
              "euirl",
              "euisl",
              "euita",
              "eultu",
              "eulux",
              "eulva",
              "eumda",
              "eumkd",
              "eumlt",
              "eumne",
              "eunld",
              "eunor",
              "eupol",
              "euprt",
              "eurou",
              "eurus",
              "eusmr",
              "eusrb",
              "eusvk",
              "eusvn",
              "euswe",
              "euukr",
              "euyug",
              "naabw",
              "naaia",
              "naant",
              "naatg",
              "nabes",
              "nabhs",
              "nablm",
              "nablz",
              "nabmu",
              "nabrb",
              "nacan",
              "nacri",
              "nacub",
              "nacuw",
              "nacym",
              "nadma",
              "nadom",
              "nagrd",
              "nagrl",
              "nagtm",
              "nahnd",
              "nahti",
              "najam",
              "nakna",
              "nalca",
              "namaf",
              "namex",
              "namsr",
              "nanic",
              "napan",
              "naslv",
              "naspm",
              "natca",
              "natto",
              "naumi",
              "nausa",
              "navct",
              "navgb",
              "ocasm",
              "ocaus",
              "occok",
              "ocfji",
              "ocfsm",
              "ocgum",
              "ockir",
              "ocmhl",
              "ocmnp",
              "ocncl",
              "ocnfk",
              "ocniu",
              "ocnru",
              "ocnzl",
              "ocpcn",
              "ocplw",
              "ocpng",
              "ocpyf",
              "ocslb",
              "octkl",
              "octon",
              "octuv",
              "ocvut",
              "ocwlf",
              "ocwsm",
              "saarg",
              "sabol",
              "sabra",
              "sachl",
              "sacol",
              "saecu",
              "saflk",
              "saguy",
              "saper",
              "sapry",
              "sasur",
              "saury",
              "saven",
              "xxatf"
            ],
            "type": "string",
            "description": "Country reporting the trade flow. Use OEC country slug."
          },
          "partner": {
            "title": "Partner (importer country)",
            "enum": [
              "",
              "afago",
              "afbdi",
              "afben",
              "afbfa",
              "afbwa",
              "afcaf",
              "afciv",
              "afcmr",
              "afcod",
              "afcog",
              "afcom",
              "afcpv",
              "afdji",
              "afdza",
              "afegy",
              "aferi",
              "afeth",
              "afgab",
              "afgha",
              "afgin",
              "afgmb",
              "afgnb",
              "afgnq",
              "afken",
              "aflbr",
              "aflby",
              "aflso",
              "afmar",
              "afmdg",
              "afmli",
              "afmoz",
              "afmrt",
              "afmus",
              "afmwi",
              "afmyt",
              "afnam",
              "afner",
              "afnga",
              "afrwa",
              "afsdn",
              "afsen",
              "afshn",
              "afsle",
              "afsom",
              "afssd",
              "afstp",
              "afswz",
              "afsyc",
              "aftcd",
              "aftgo",
              "aftun",
              "aftza",
              "afuga",
              "afzaf",
              "afzmb",
              "afzwe",
              "asafg",
              "asare",
              "asarm",
              "asaze",
              "asbgd",
              "asbhr",
              "asbrn",
              "asbtn",
              "ascck",
              "aschn",
              "ascxr",
              "ascyp",
              "asgeo",
              "ashkg",
              "asidn",
              "asind",
              "asiot",
              "asirn",
              "asirq",
              "asisr",
              "asjor",
              "asjpn",
              "askaz",
              "askgz",
              "askhm",
              "askor",
              "askwt",
              "aslao",
              "aslbn",
              "aslka",
              "asmac",
              "asmdv",
              "asmmr",
              "asmng",
              "asmys",
              "asnpl",
              "asomn",
              "aspak",
              "asphl",
              "asprk",
              "aspse",
              "asqat",
              "assau",
              "assgp",
              "assyr",
              "astha",
              "astjk",
              "astkm",
              "astls",
              "astur",
              "astwn",
              "asuzb",
              "asvnm",
              "asyem",
              "eualb",
              "euand",
              "euaut",
              "eubel",
              "eubgr",
              "eubih",
              "eublr",
              "eublx",
              "euche",
              "eucze",
              "eudeu",
              "eudnk",
              "euesp",
              "euest",
              "eufin",
              "eufra",
              "eugbr",
              "eugib",
              "eugrc",
              "euhrv",
              "euhun",
              "euirl",
              "euisl",
              "euita",
              "eultu",
              "eulux",
              "eulva",
              "eumda",
              "eumkd",
              "eumlt",
              "eumne",
              "eunld",
              "eunor",
              "eupol",
              "euprt",
              "eurou",
              "eurus",
              "eusmr",
              "eusrb",
              "eusvk",
              "eusvn",
              "euswe",
              "euukr",
              "euyug",
              "naabw",
              "naaia",
              "naant",
              "naatg",
              "nabes",
              "nabhs",
              "nablm",
              "nablz",
              "nabmu",
              "nabrb",
              "nacan",
              "nacri",
              "nacub",
              "nacuw",
              "nacym",
              "nadma",
              "nadom",
              "nagrd",
              "nagrl",
              "nagtm",
              "nahnd",
              "nahti",
              "najam",
              "nakna",
              "nalca",
              "namaf",
              "namex",
              "namsr",
              "nanic",
              "napan",
              "naslv",
              "naspm",
              "natca",
              "natto",
              "naumi",
              "nausa",
              "navct",
              "navgb",
              "ocasm",
              "ocaus",
              "occok",
              "ocfji",
              "ocfsm",
              "ocgum",
              "ockir",
              "ocmhl",
              "ocmnp",
              "ocncl",
              "ocnfk",
              "ocniu",
              "ocnru",
              "ocnzl",
              "ocpcn",
              "ocplw",
              "ocpng",
              "ocpyf",
              "ocslb",
              "octkl",
              "octon",
              "octuv",
              "ocvut",
              "ocwlf",
              "ocwsm",
              "saarg",
              "sabol",
              "sabra",
              "sachl",
              "sacol",
              "saecu",
              "saflk",
              "saguy",
              "saper",
              "sapry",
              "sasur",
              "saury",
              "saven",
              "xxatf"
            ],
            "type": "string",
            "description": "Optional partner country for bilateral flows. Leave blank for world totals."
          },
          "productLevel": {
            "title": "Product breakdown",
            "enum": [
              "none",
              "hs4",
              "hs6",
              "sitc4"
            ],
            "type": "string",
            "description": "Aggregation depth for products. None returns country totals only."
          },
          "hsCode": {
            "title": "HS code filter",
            "type": "string",
            "description": "Optional HS4 or HS6 numeric code to filter results (e.g. 8542 for ICs). Leave blank for all."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}