{
  "openapi": "3.0.1",
  "info": {
    "title": "X (twitter) Trends by Country",
    "description": "Get the latest trends for a selected country or for all countries in plain language.",
    "version": "0.0",
    "x-build-id": "P6dG5s6I8TFZNUfmL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datamagnet~x-twitter-trends-by-country/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datamagnet-x-twitter-trends-by-country",
        "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/datamagnet~x-twitter-trends-by-country/runs": {
      "post": {
        "operationId": "runs-sync-datamagnet-x-twitter-trends-by-country",
        "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/datamagnet~x-twitter-trends-by-country/run-sync": {
      "post": {
        "operationId": "run-sync-datamagnet-x-twitter-trends-by-country",
        "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": [
          "country"
        ],
        "properties": {
          "country": {
            "title": "Country",
            "enum": [
              "ALL",
              "USA",
              "FRA",
              "AFG",
              "ALB",
              "DZA",
              "AND",
              "AGO",
              "ATG",
              "ARG",
              "ARM",
              "AUS",
              "AUT",
              "AZE",
              "BHS",
              "BHR",
              "BGD",
              "BRB",
              "BLR",
              "BEL",
              "BLZ",
              "BEN",
              "BTN",
              "BOL",
              "BIH",
              "BWA",
              "BRA",
              "BRN",
              "BGR",
              "BFA",
              "BDI",
              "KHM",
              "CMR",
              "CAN",
              "CPV",
              "CAF",
              "TCD",
              "CHL",
              "CHN",
              "COL",
              "COM",
              "COG",
              "CRI",
              "CIV",
              "HRV",
              "CUB",
              "CYP",
              "CZE",
              "DNK",
              "DJI",
              "DMA",
              "DOM",
              "ECU",
              "EGY",
              "SLV",
              "GNQ",
              "ERI",
              "EST",
              "SWZ",
              "ETH",
              "FJI",
              "FIN",
              "GAB",
              "GMB",
              "GEO",
              "DEU",
              "GHA",
              "GRC",
              "GRD",
              "GTM",
              "GIN",
              "GNB",
              "GUY",
              "HTI",
              "HND",
              "HUN",
              "ISL",
              "IND",
              "IDN",
              "IRN",
              "IRQ",
              "IRL",
              "ISR",
              "ITA",
              "JAM",
              "JPN",
              "JOR",
              "KAZ",
              "KEN",
              "KIR",
              "KWT",
              "KGZ",
              "LAO",
              "LVA",
              "LBN",
              "LSO",
              "LBR",
              "LBY",
              "LIE",
              "LTU",
              "LUX",
              "MDG",
              "MWI",
              "MYS",
              "MDV",
              "MLI",
              "MLT",
              "MHL",
              "MRT",
              "MUS",
              "MEX",
              "FSM",
              "MDA",
              "MCO",
              "MNG",
              "MNE",
              "MAR",
              "MOZ",
              "MMR",
              "NAM",
              "NRU",
              "NPL",
              "NLD",
              "NZL",
              "NIC",
              "NER",
              "NGA",
              "MKD",
              "NOR",
              "OMN",
              "PAK",
              "PLW",
              "PAN",
              "PNG",
              "PRY",
              "PER",
              "PHL",
              "POL",
              "PRT",
              "QAT",
              "ROU",
              "RUS",
              "RWA",
              "KNA",
              "LCA",
              "VCT",
              "WSM",
              "SMR",
              "STP",
              "SAU",
              "SEN",
              "SRB",
              "SYC",
              "SLE",
              "SGP",
              "SVK",
              "SVN",
              "SLB",
              "SOM",
              "ZAF",
              "SSD",
              "ESP",
              "LKA",
              "SDN",
              "SUR",
              "SWE",
              "CHE",
              "SYR",
              "TJK",
              "TZA",
              "THA",
              "TLS",
              "TGO",
              "TON",
              "TTO",
              "TUN",
              "TUR",
              "TKM",
              "TUV",
              "UGA",
              "UKR",
              "ARE",
              "GBR",
              "URY",
              "UZB",
              "VUT",
              "VEN",
              "VNM",
              "YEM",
              "ZMB",
              "ZWE"
            ],
            "type": "string",
            "description": "Choose the country you want trend data for, or select ALL to get the full global list."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}