{
  "openapi": "3.0.1",
  "info": {
    "title": "Keyword Search Volume — Bulk Google Metrics (CPC & Trend)",
    "description": "Get Google search volume, CPC, ad competition and a 12-month trend for thousands of keywords in one run. Expand seed keywords into related ideas, target any country, and get intent, opportunity score and click estimates. No Google Ads account or API key needed.",
    "version": "1.0",
    "x-build-id": "fvUI49XidCVTLrpXJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/insights_data~keyword-search-volume/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-insights_data-keyword-search-volume",
        "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/insights_data~keyword-search-volume/runs": {
      "post": {
        "operationId": "runs-sync-insights_data-keyword-search-volume",
        "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/insights_data~keyword-search-volume/run-sync": {
      "post": {
        "operationId": "run-sync-insights_data-keyword-search-volume",
        "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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "🔑 Keywords",
            "type": "array",
            "description": "Keywords to look up, one per line (bulk lists welcome; duplicates are removed, keywords are lower-cased like Google Keyword Planner does). In Metrics mode these are measured directly; in Ideas mode they are seeds that get expanded into related keywords. Free plan users are limited to 10 items per run; paid plans have no limit.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "🧭 Mode",
            "enum": [
              "metrics",
              "ideas"
            ],
            "type": "string",
            "description": "Metrics = volume, CPC and competition for exactly the keywords you provide. Ideas = expand your seeds into related keywords and return their metrics too (seeds first, then the highest-volume ideas).",
            "default": "metrics"
          },
          "maxIdeas": {
            "title": "💡 Max idea rows (Ideas mode)",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Ideas mode only: total keyword rows returned per location, seeds included (1-1,000). If many ideas come back without search volume, more ideas are measured until this many rows carry volume or no ideas are left. Ignored in Metrics mode. Free plan users are limited to 10 items per run; paid plans have no limit.",
            "default": 10
          },
          "locations": {
            "title": "🌍 Location",
            "type": "array",
            "description": "Countries to measure volume in. Pick several to get one set of rows per country. Worldwide (global) = volume across all countries. Empty = United States.",
            "items": {
              "type": "string",
              "enum": [
                "global",
                "af",
                "al",
                "dz",
                "ad",
                "ao",
                "ag",
                "ar",
                "am",
                "au",
                "at",
                "az",
                "bs",
                "bh",
                "bd",
                "bb",
                "by",
                "be",
                "bz",
                "bj",
                "bt",
                "bo",
                "ba",
                "bw",
                "br",
                "bn",
                "bg",
                "bf",
                "bi",
                "kh",
                "cm",
                "ca",
                "cv",
                "cf",
                "td",
                "cl",
                "cn",
                "co",
                "km",
                "cr",
                "ci",
                "hr",
                "cy",
                "cz",
                "cd",
                "dk",
                "dj",
                "dm",
                "do",
                "ec",
                "eg",
                "sv",
                "gq",
                "er",
                "ee",
                "sz",
                "et",
                "fj",
                "fi",
                "fr",
                "ga",
                "gm",
                "ge",
                "de",
                "gh",
                "gr",
                "gd",
                "gt",
                "gn",
                "gw",
                "gy",
                "ht",
                "hn",
                "hk",
                "hu",
                "is",
                "in",
                "id",
                "iq",
                "ie",
                "il",
                "it",
                "jm",
                "jp",
                "jo",
                "kz",
                "ke",
                "ki",
                "kw",
                "kg",
                "la",
                "lv",
                "lb",
                "ls",
                "lr",
                "ly",
                "li",
                "lt",
                "lu",
                "mo",
                "mg",
                "mw",
                "my",
                "mv",
                "ml",
                "mt",
                "mh",
                "mr",
                "mu",
                "mx",
                "fm",
                "md",
                "mc",
                "mn",
                "me",
                "ma",
                "mz",
                "mm",
                "na",
                "nr",
                "np",
                "nl",
                "nz",
                "ni",
                "ne",
                "ng",
                "mk",
                "no",
                "om",
                "pk",
                "pw",
                "ps",
                "pa",
                "pg",
                "py",
                "pe",
                "ph",
                "pl",
                "pt",
                "pr",
                "qa",
                "cg",
                "ro",
                "ru",
                "rw",
                "kn",
                "lc",
                "vc",
                "ws",
                "sm",
                "st",
                "sa",
                "sn",
                "rs",
                "sc",
                "sl",
                "sg",
                "sk",
                "si",
                "sb",
                "so",
                "za",
                "kr",
                "ss",
                "es",
                "lk",
                "sd",
                "sr",
                "se",
                "ch",
                "tw",
                "tj",
                "tz",
                "th",
                "tl",
                "tg",
                "to",
                "tt",
                "tn",
                "tr",
                "tm",
                "tv",
                "ug",
                "ua",
                "ae",
                "gb",
                "us",
                "uy",
                "uz",
                "vu",
                "va",
                "ve",
                "vn",
                "ye",
                "zm",
                "zw"
              ],
              "enumTitles": [
                "🌐 Worldwide (global)",
                "Afghanistan (AF)",
                "Albania (AL)",
                "Algeria (DZ)",
                "Andorra (AD)",
                "Angola (AO)",
                "Antigua and Barbuda (AG)",
                "Argentina (AR)",
                "Armenia (AM)",
                "Australia (AU)",
                "Austria (AT)",
                "Azerbaijan (AZ)",
                "Bahamas (BS)",
                "Bahrain (BH)",
                "Bangladesh (BD)",
                "Barbados (BB)",
                "Belarus (BY)",
                "Belgium (BE)",
                "Belize (BZ)",
                "Benin (BJ)",
                "Bhutan (BT)",
                "Bolivia (BO)",
                "Bosnia and Herzegovina (BA)",
                "Botswana (BW)",
                "Brazil (BR)",
                "Brunei (BN)",
                "Bulgaria (BG)",
                "Burkina Faso (BF)",
                "Burundi (BI)",
                "Cambodia (KH)",
                "Cameroon (CM)",
                "Canada (CA)",
                "Cape Verde (CV)",
                "Central African Republic (CF)",
                "Chad (TD)",
                "Chile (CL)",
                "China (CN)",
                "Colombia (CO)",
                "Comoros (KM)",
                "Costa Rica (CR)",
                "Cote d'Ivoire (CI)",
                "Croatia (HR)",
                "Cyprus (CY)",
                "Czechia (CZ)",
                "Democratic Republic of the Congo (CD)",
                "Denmark (DK)",
                "Djibouti (DJ)",
                "Dominica (DM)",
                "Dominican Republic (DO)",
                "Ecuador (EC)",
                "Egypt (EG)",
                "El Salvador (SV)",
                "Equatorial Guinea (GQ)",
                "Eritrea (ER)",
                "Estonia (EE)",
                "Eswatini (SZ)",
                "Ethiopia (ET)",
                "Fiji (FJ)",
                "Finland (FI)",
                "France (FR)",
                "Gabon (GA)",
                "Gambia (GM)",
                "Georgia (GE)",
                "Germany (DE)",
                "Ghana (GH)",
                "Greece (GR)",
                "Grenada (GD)",
                "Guatemala (GT)",
                "Guinea (GN)",
                "Guinea-Bissau (GW)",
                "Guyana (GY)",
                "Haiti (HT)",
                "Honduras (HN)",
                "Hong Kong (HK)",
                "Hungary (HU)",
                "Iceland (IS)",
                "India (IN)",
                "Indonesia (ID)",
                "Iraq (IQ)",
                "Ireland (IE)",
                "Israel (IL)",
                "Italy (IT)",
                "Jamaica (JM)",
                "Japan (JP)",
                "Jordan (JO)",
                "Kazakhstan (KZ)",
                "Kenya (KE)",
                "Kiribati (KI)",
                "Kuwait (KW)",
                "Kyrgyzstan (KG)",
                "Laos (LA)",
                "Latvia (LV)",
                "Lebanon (LB)",
                "Lesotho (LS)",
                "Liberia (LR)",
                "Libya (LY)",
                "Liechtenstein (LI)",
                "Lithuania (LT)",
                "Luxembourg (LU)",
                "Macau (MO)",
                "Madagascar (MG)",
                "Malawi (MW)",
                "Malaysia (MY)",
                "Maldives (MV)",
                "Mali (ML)",
                "Malta (MT)",
                "Marshall Islands (MH)",
                "Mauritania (MR)",
                "Mauritius (MU)",
                "Mexico (MX)",
                "Micronesia (FM)",
                "Moldova (MD)",
                "Monaco (MC)",
                "Mongolia (MN)",
                "Montenegro (ME)",
                "Morocco (MA)",
                "Mozambique (MZ)",
                "Myanmar (MM)",
                "Namibia (NA)",
                "Nauru (NR)",
                "Nepal (NP)",
                "Netherlands (NL)",
                "New Zealand (NZ)",
                "Nicaragua (NI)",
                "Niger (NE)",
                "Nigeria (NG)",
                "North Macedonia (MK)",
                "Norway (NO)",
                "Oman (OM)",
                "Pakistan (PK)",
                "Palau (PW)",
                "Palestine (PS)",
                "Panama (PA)",
                "Papua New Guinea (PG)",
                "Paraguay (PY)",
                "Peru (PE)",
                "Philippines (PH)",
                "Poland (PL)",
                "Portugal (PT)",
                "Puerto Rico (PR)",
                "Qatar (QA)",
                "Republic of the Congo (CG)",
                "Romania (RO)",
                "Russia (RU)",
                "Rwanda (RW)",
                "Saint Kitts and Nevis (KN)",
                "Saint Lucia (LC)",
                "Saint Vincent and the Grenadines (VC)",
                "Samoa (WS)",
                "San Marino (SM)",
                "Sao Tome and Principe (ST)",
                "Saudi Arabia (SA)",
                "Senegal (SN)",
                "Serbia (RS)",
                "Seychelles (SC)",
                "Sierra Leone (SL)",
                "Singapore (SG)",
                "Slovakia (SK)",
                "Slovenia (SI)",
                "Solomon Islands (SB)",
                "Somalia (SO)",
                "South Africa (ZA)",
                "South Korea (KR)",
                "South Sudan (SS)",
                "Spain (ES)",
                "Sri Lanka (LK)",
                "Sudan (SD)",
                "Suriname (SR)",
                "Sweden (SE)",
                "Switzerland (CH)",
                "Taiwan (TW)",
                "Tajikistan (TJ)",
                "Tanzania (TZ)",
                "Thailand (TH)",
                "Timor-Leste (TL)",
                "Togo (TG)",
                "Tonga (TO)",
                "Trinidad and Tobago (TT)",
                "Tunisia (TN)",
                "Turkiye (TR)",
                "Turkmenistan (TM)",
                "Tuvalu (TV)",
                "Uganda (UG)",
                "Ukraine (UA)",
                "United Arab Emirates (AE)",
                "United Kingdom (GB)",
                "United States (US)",
                "Uruguay (UY)",
                "Uzbekistan (UZ)",
                "Vanuatu (VU)",
                "Vatican City (VA)",
                "Venezuela (VE)",
                "Vietnam (VN)",
                "Yemen (YE)",
                "Zambia (ZM)",
                "Zimbabwe (ZW)"
              ]
            }
          },
          "language": {
            "title": "🔤 Language",
            "enum": [
              "auto",
              "all",
              "ar",
              "bn",
              "bg",
              "ca",
              "zh_CN",
              "zh_TW",
              "hr",
              "cs",
              "da",
              "nl",
              "en",
              "et",
              "tl",
              "fi",
              "fr",
              "de",
              "el",
              "iw",
              "hi",
              "hu",
              "is",
              "id",
              "it",
              "ja",
              "ko",
              "lv",
              "lt",
              "ms",
              "no",
              "fa",
              "pl",
              "pt",
              "ro",
              "ru",
              "sr",
              "sk",
              "sl",
              "es",
              "sv",
              "th",
              "tr",
              "uk",
              "ur",
              "vi"
            ],
            "type": "string",
            "description": "Language used for keyword ideas, spelling and Google Trends. Auto picks the main language of each country; All languages = no language filter.",
            "default": "auto"
          },
          "network": {
            "title": "📡 Network",
            "enum": [
              "GOOGLE_SEARCH",
              "GOOGLE_SEARCH_AND_PARTNERS"
            ],
            "type": "string",
            "description": "Kept for compatibility with other keyword tools. Search-partner volumes are not available, so every row reports Google Search only (search_partners = false) whichever option you pick.",
            "default": "GOOGLE_SEARCH"
          },
          "ideaSources": {
            "title": "🧩 Idea sources",
            "type": "array",
            "description": "Where keyword ideas come from in Ideas mode. Pick one or more.",
            "items": {
              "type": "string",
              "enum": [
                "google_autocomplete",
                "youtube_autocomplete",
                "shopping_autocomplete",
                "amazon_autocomplete",
                "google_trends_related"
              ],
              "enumTitles": [
                "Google search suggestions",
                "YouTube search suggestions",
                "Google Shopping suggestions",
                "Amazon search suggestions",
                "Google Trends related queries"
              ]
            },
            "default": [
              "google_autocomplete"
            ]
          },
          "autocompleteDepth": {
            "title": "🔬 Idea search depth",
            "enum": [
              "basic",
              "questions",
              "full"
            ],
            "type": "string",
            "description": "Starting depth. Basic = the seed itself; Questions = also how / what / why / can … questions; Full = also modifiers (best, vs, for, near me…) and a-z letters. The search goes deeper on its own when too few ideas are found.",
            "default": "questions"
          },
          "maxIdeaCandidates": {
            "title": "🧮 Ideas measured per location",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many discovered ideas are measured before the best Max idea rows are kept (never fewer than Max idea rows). More candidates = better picks, longer run.",
            "default": 300
          },
          "unsupportedLocation": {
            "title": "🚩 Locations without country data",
            "enum": [
              "skip",
              "global"
            ],
            "type": "string",
            "description": "Country-level volume is available for a set of major markets. For other countries: skip = keep the rows but leave volume empty (status unsupported_location); global = use worldwide volume instead (volume_scope = global).",
            "default": "skip"
          },
          "dataSource": {
            "title": "📚 Data source",
            "enum": [
              "keyword_planner",
              "keyword_planner_clickstream"
            ],
            "type": "string",
            "description": "Google Keyword Planner only, or Keyword Planner blended with clickstream data.",
            "default": "keyword_planner"
          },
          "currency": {
            "title": "💱 Currency",
            "pattern": "^[A-Za-z]{3}$",
            "type": "string",
            "description": "ISO-4217 code (USD, EUR, GBP, INR…). CPC and bid values are converted at today's exchange rate; unknown codes stay in USD.",
            "default": "USD"
          },
          "includeMonthlySearches": {
            "title": "📅 Monthly searches (last 12 months)",
            "type": "boolean",
            "description": "Adds monthly_searches: one entry per month with the search volume.",
            "default": true
          },
          "includeTrendAnalytics": {
            "title": "📉 Trend analytics",
            "type": "boolean",
            "description": "Adds trend (rising / stable / declining), month-over-month and quarter-over-quarter change, peak and lowest month, seasonality index and spike months.",
            "default": true
          },
          "includeKeywordProfile": {
            "title": "🧬 Keyword profile & value",
            "type": "boolean",
            "description": "Adds word count, head / body / long-tail class, question flag, search intent, opportunity score (0-100) and estimated clicks and traffic value at position 1.",
            "default": true
          },
          "clusterKeywords": {
            "title": "🔗 Topic clusters",
            "type": "boolean",
            "description": "Groups keywords about the same topic; cluster = the cluster's leading keyword.",
            "default": true
          },
          "includeSpellCheck": {
            "title": "📝 Google spelling check",
            "type": "boolean",
            "description": "spell = Google's spelling of the keyword; spell_corrected = true when Google rewrites it.",
            "default": true
          },
          "includeGoogleTrends": {
            "title": "📈 Google Trends interest",
            "type": "boolean",
            "description": "Adds google_trends: latest and average interest (0-100), peak date, 12-month change and a breakout flag. Slower: Google Trends answers a few requests per minute.",
            "default": false
          },
          "trendsTimeframe": {
            "title": "⌛ Google Trends timeframe",
            "enum": [
              "today 3-m",
              "today 12-m",
              "today 5-y",
              "all"
            ],
            "type": "string",
            "description": "Period used for Google Trends interest.",
            "default": "today 5-y"
          },
          "includeTrendsSeries": {
            "title": "📊 Google Trends full series",
            "type": "boolean",
            "description": "Also adds every Google Trends data point (date + interest) inside google_trends.series.",
            "default": false
          },
          "minVolume": {
            "title": "🔼 Min search volume",
            "minimum": 0,
            "type": "integer",
            "description": "Drop keywords below this monthly volume. 0 = no minimum.",
            "default": 0
          },
          "maxVolume": {
            "title": "🔽 Max search volume",
            "minimum": 0,
            "type": "integer",
            "description": "Drop keywords above this monthly volume. 0 = no maximum.",
            "default": 0
          },
          "minCpc": {
            "title": "💵 Min CPC",
            "minimum": 0,
            "type": "number",
            "description": "Drop keywords with a lower cost per click. 0 = no minimum.",
            "default": 0
          },
          "maxCpc": {
            "title": "💰 Max CPC",
            "minimum": 0,
            "type": "number",
            "description": "Drop keywords with a higher cost per click. 0 = no maximum.",
            "default": 0
          },
          "competitionLevels": {
            "title": "🥊 Competition levels",
            "type": "array",
            "description": "Keep only these ad-competition levels. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "LOW",
                "MEDIUM",
                "HIGH"
              ],
              "enumTitles": [
                "Low",
                "Medium",
                "High"
              ]
            },
            "default": []
          },
          "includeTerms": {
            "title": "➕ Must contain",
            "type": "array",
            "description": "Keep only keywords containing at least one of these words or phrases.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeTerms": {
            "title": "➖ Must not contain",
            "type": "array",
            "description": "Drop keywords containing any of these words (whole-word match).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minWords": {
            "title": "📏 Min words",
            "minimum": 0,
            "type": "integer",
            "description": "Keep keywords with at least this many words. 0 = no minimum.",
            "default": 0
          },
          "maxWords": {
            "title": "📐 Max words",
            "minimum": 0,
            "type": "integer",
            "description": "Keep keywords with at most this many words. 0 = no maximum.",
            "default": 0
          },
          "onlyQuestions": {
            "title": "❓ Questions only",
            "type": "boolean",
            "description": "Keep only question keywords (how, what, why, can…).",
            "default": false
          },
          "includeAdultKeywords": {
            "title": "🔞 Include adult keywords",
            "type": "boolean",
            "description": "Kept for compatibility with other keyword tools. Results are never filtered for adult terms, so this switch changes nothing.",
            "default": false
          },
          "intents": {
            "title": "🧲 Search intents",
            "type": "array",
            "description": "Keep only these search intents. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "informational",
                "commercial",
                "transactional",
                "navigational"
              ],
              "enumTitles": [
                "Informational",
                "Commercial",
                "Transactional",
                "Navigational"
              ]
            },
            "default": []
          },
          "trends": {
            "title": "🌊 Trend direction",
            "type": "array",
            "description": "Keep only keywords whose 12-month trend is one of these. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "rising",
                "stable",
                "declining"
              ],
              "enumTitles": [
                "Rising",
                "Stable",
                "Declining"
              ]
            },
            "default": []
          },
          "sortBy": {
            "title": "🔃 Sort rows by",
            "enum": [
              "search_volume",
              "cpc",
              "competition_index",
              "opportunity",
              "trend",
              "yoy_change",
              "keyword"
            ],
            "type": "string",
            "description": "Leave empty to keep your input order (rows then appear live while the run works). Sorting delivers each location's rows once all of its keywords are measured. Highest first, except keyword (A-Z)."
          },
          "maxResults": {
            "title": "🏁 Max results per location",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on rows per location after filters. 0 = no cap. Free plan users are limited to 10 items per run; paid plans have no limit.",
            "default": 0
          },
          "keepAllInputRows": {
            "title": "📌 Keep a row for every input keyword",
            "type": "boolean",
            "description": "Metrics mode: keywords that could not be measured still get a row with a status explaining why, even when filters are set.",
            "default": true
          },
          "outputFormat": {
            "title": "🧾 Row format",
            "enum": [
              "full",
              "flat"
            ],
            "type": "string",
            "description": "Full = nested JSON (monthly_searches as a list). Flat = one level for spreadsheets: monthly values become m_YYYY_MM columns and lists are joined with |.",
            "default": "full"
          },
          "writeCsv": {
            "title": "📄 Also save a CSV file",
            "type": "boolean",
            "description": "Saves keywords.csv (flat columns) in the run's key-value store, next to the dataset.",
            "default": false
          },
          "cacheTtlHours": {
            "title": "💾 Reuse recent results (hours)",
            "minimum": 0,
            "maximum": 720,
            "type": "integer",
            "description": "Keyword Planner data changes monthly, so metrics measured for the same keyword and market within this many hours are reused (stored in your own Apify account). 0 = always measure fresh.",
            "default": 168
          },
          "monitorChanges": {
            "title": "🔔 Track changes between runs",
            "type": "boolean",
            "description": "Remembers each keyword's volume (in your own Apify account) and adds is_new, previous_search_volume and volume_change_pct on the next runs.",
            "default": false
          },
          "concurrency": {
            "title": "🚀 Parallel idea and spelling requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many idea and spelling look-ups run at the same time.",
            "default": 5
          },
          "lanesConcurrency": {
            "title": "🚦 Parallel requests per connection",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Volume look-ups in flight per connection at the same time.",
            "default": 2
          },
          "maxRetries": {
            "title": "🔁 Retries per request",
            "minimum": 0,
            "maximum": 6,
            "type": "integer",
            "description": "Retries for a request that fails to connect or gets a server error.",
            "default": 3
          },
          "proxySessions": {
            "title": "🧷 Proxy IPs per run",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "When a proxy is used, how many separate proxy IPs the work is spread over.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy",
            "type": "object",
            "description": "Starts without a proxy. If requests are blocked, the run switches to a datacenter proxy, then to a residential proxy, and stays on residential for the rest of the run. Pick a proxy here to start on it directly.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}