{
  "openapi": "3.0.1",
  "info": {
    "title": "US Emergency Alert Translator",
    "description": "Translate US emergency alerts from NWS, FEMA, and CDC into 18+ languages in real-time using AI. Tornado warnings, hurricane alerts, and public health emergencies—delivered in Spanish, Chinese, Vietnamese, Arabic, Korean, and 13 more languages for 68 million non-English speakers.",
    "version": "0.0",
    "x-build-id": "gzOgmPxLqv2mn5m1W"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yoloshii~us-emergency-alert-translator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yoloshii-us-emergency-alert-translator",
        "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/yoloshii~us-emergency-alert-translator/runs": {
      "post": {
        "operationId": "runs-sync-yoloshii-us-emergency-alert-translator",
        "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/yoloshii~us-emergency-alert-translator/run-sync": {
      "post": {
        "operationId": "run-sync-yoloshii-us-emergency-alert-translator",
        "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": [
          "lingo_api_key"
        ],
        "properties": {
          "lingo_api_key": {
            "title": "Lingo.dev API Key",
            "type": "string",
            "description": "Your lingo.dev API key for AI-powered translation. Get one at https://lingo.dev"
          },
          "state_preset": {
            "title": "State Preset",
            "enum": [
              "custom",
              "nationwide",
              "gulf_coast",
              "atlantic_coast",
              "tornado_alley",
              "west_coast",
              "top_10_population"
            ],
            "type": "string",
            "description": "Quick selection for common state groupings. Use 'Custom' to specify individual states below.",
            "default": "nationwide"
          },
          "states": {
            "title": "US States to Monitor",
            "type": "array",
            "description": "Only used when State Preset is 'Custom'. Use 2-letter codes: CA, TX, FL, NY, etc.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "target_languages": {
            "title": "Target Languages",
            "type": "array",
            "description": "Use 2-letter codes: es (Spanish), zh-Hans (Chinese Simplified), vi (Vietnamese), ar (Arabic), tl (Tagalog), fr (French), ko (Korean), ru (Russian), ht (Haitian Creole), pt (Portuguese), ja (Japanese), pl (Polish), hi (Hindi), bn (Bengali), fa (Persian), de (German), ur (Urdu). Or use Language Preset below for quick selection.",
            "default": [
              "es"
            ],
            "items": {
              "type": "string"
            }
          },
          "language_preset": {
            "title": "Language Preset",
            "enum": [
              "custom",
              "spanish_only",
              "top_5",
              "fcc_13",
              "all_18"
            ],
            "type": "string",
            "description": "Quick selection for common language sets. Overrides target_languages if selected.",
            "default": "custom"
          },
          "include_cdc": {
            "title": "Include CDC Health Alerts",
            "type": "boolean",
            "description": "Enable CDC Health Alert Network collection. Fetches full health alert content (~10s extra processing time).",
            "default": false
          },
          "data_sources": {
            "title": "Alert Sources (Advanced)",
            "type": "object",
            "description": "Advanced: Configure NWS/FEMA sources. Use 'Include CDC Health Alerts' toggle above for CDC.",
            "default": {
              "nws": true,
              "fema": true
            }
          },
          "severity_threshold": {
            "title": "Minimum Severity",
            "enum": [
              "Minor",
              "Moderate",
              "Severe",
              "Extreme"
            ],
            "type": "string",
            "description": "Only translate alerts at or above this severity level",
            "default": "Moderate"
          },
          "urgency_threshold": {
            "title": "Minimum Urgency",
            "enum": [
              "Future",
              "Expected",
              "Immediate"
            ],
            "type": "string",
            "description": "Only translate alerts at or above this urgency level",
            "default": "Expected"
          },
          "webhook_urls": {
            "title": "Webhook URLs",
            "type": "array",
            "description": "POST translated alerts to these webhook endpoints (Slack, Discord, custom apps)",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "max_alerts_per_run": {
            "title": "Max Alerts Per Run",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Limit alerts processed per run (controls translation costs)",
            "default": 50
          },
          "deduplication_hours": {
            "title": "Deduplication Window (hours)",
            "minimum": 1,
            "maximum": 168,
            "type": "integer",
            "description": "Skip alerts already translated within this time window",
            "default": 24
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}