{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Jobs Vertical: Pay Bands, Highlights & Apply Routes",
    "description": "Search Google's Jobs vertical by keyword, place, country and language. Export parsed salary bands, employer logos, remote and no-degree flags, Google's qualification/responsibility/benefit highlights, and every apply option with its real URL.",
    "version": "1.0",
    "x-build-id": "pXTO2nPDAQePTVOZa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xyrelith-data~google-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xyrelith-data-google-jobs-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/xyrelith-data~google-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-xyrelith-data-google-jobs-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/xyrelith-data~google-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-xyrelith-data-google-jobs-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byUrl"
            ],
            "type": "string",
            "description": "Search Google Jobs, or parse Google Jobs search/share URLs you already have.",
            "default": "search"
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Job titles, skills or phrases. Each query is searched in every location. Example: software engineer, registered nurse, data analyst.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities, regions or countries added to each search as 'jobs near ...'. Leave empty to search the whole country selected below.",
            "items": {
              "type": "string"
            }
          },
          "gl": {
            "title": "Google country",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "ie",
              "nz",
              "de",
              "at",
              "ch",
              "fr",
              "be",
              "nl",
              "lu",
              "es",
              "pt",
              "it",
              "gr",
              "mt",
              "cy",
              "se",
              "no",
              "dk",
              "fi",
              "is",
              "pl",
              "cz",
              "sk",
              "hu",
              "ro",
              "bg",
              "si",
              "hr",
              "rs",
              "ba",
              "mk",
              "al",
              "me",
              "lt",
              "lv",
              "ee",
              "ua",
              "md",
              "by",
              "ru",
              "tr",
              "ge",
              "am",
              "az",
              "kz",
              "uz",
              "il",
              "ae",
              "sa",
              "qa",
              "kw",
              "om",
              "bh",
              "jo",
              "lb",
              "eg",
              "ma",
              "tn",
              "dz",
              "ng",
              "ke",
              "za",
              "gh",
              "in",
              "pk",
              "bd",
              "lk",
              "np",
              "sg",
              "my",
              "id",
              "ph",
              "th",
              "vn",
              "hk",
              "tw",
              "jp",
              "kr",
              "cn",
              "br",
              "mx",
              "ar",
              "cl",
              "co",
              "pe",
              "uy",
              "ec",
              "ve",
              "cr",
              "pa",
              "do",
              "gt"
            ],
            "type": "string",
            "description": "Country market for the search (Google's gl parameter). Also steers the proxy exit country. Google Jobs is not available in every market.",
            "default": "us"
          },
          "hl": {
            "title": "Interface language",
            "enum": [
              "auto",
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "pt-BR",
              "nl",
              "sv",
              "no",
              "da",
              "fi",
              "is",
              "pl",
              "cs",
              "sk",
              "hu",
              "ro",
              "bg",
              "el",
              "hr",
              "sr",
              "sl",
              "lt",
              "lv",
              "et",
              "ru",
              "uk",
              "tr",
              "ar",
              "he",
              "fa",
              "hi",
              "bn",
              "ur",
              "ta",
              "te",
              "ml",
              "kn",
              "mr",
              "gu",
              "th",
              "vi",
              "id",
              "ms",
              "tl",
              "ja",
              "ko",
              "zh-CN",
              "zh-TW"
            ],
            "type": "string",
            "description": "Language Google uses for the interface and for Google's own filter labels (hl parameter). Keep 'Same as country' for non-English markets: forcing English there often returns no jobs.",
            "default": "auto"
          },
          "radiusKm": {
            "title": "Radius hint (km)",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Best-effort radius hint appended to the search phrase. Google Jobs has no true radius parameter, so treat it as a hint, not a hard boundary. 0 disables it.",
            "default": 0
          },
          "datePosted": {
            "title": "Date posted",
            "enum": [
              "any",
              "past24h",
              "past3days",
              "pastWeek",
              "pastMonth"
            ],
            "type": "string",
            "description": "Keep jobs posted in this window. Google renders the age on each card; the actor also checks the computed date before keeping a row.",
            "default": "any"
          },
          "jobType": {
            "title": "Job type",
            "enum": [
              "any",
              "fullTime",
              "partTime",
              "contractor",
              "internship",
              "temporary"
            ],
            "type": "string",
            "description": "Keep only full-time, part-time, contractor, internship or temporary roles. Rows whose employment type is unknown pass through.",
            "default": "any"
          },
          "remoteOnly": {
            "title": "Remote / work from home only",
            "type": "boolean",
            "description": "Keep jobs Google tags as remote or work from home, or whose location is Anywhere/Remote.",
            "default": false
          },
          "noDegreeOnly": {
            "title": "No degree mentioned only",
            "type": "boolean",
            "description": "Keep jobs where Google's 'No degree mentioned' tag is present, or whose description names no degree requirement.",
            "default": false
          },
          "company": {
            "title": "Employer",
            "type": "string",
            "description": "Optional employer name. Added to the search and checked against each row's employer.",
            "default": ""
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum rows to save across all queries, locations and filter slices.",
            "default": 50
          },
          "fanOut": {
            "title": "Fan out across filter slices",
            "type": "boolean",
            "description": "Google shows about 10 jobs per search. When enabled and maxJobs is above 10, the actor repeats the search with Google's filter phrases (date, job type, remote, no degree) and de-duplicates by job ID to go past that cap. Disable for one request per query.",
            "default": true
          },
          "maxSearchesPerQuery": {
            "title": "Max filter slices per query",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Upper bound on the filter slices fetched for each query when fan-out is on. Higher values find more jobs and use more SERP requests.",
            "default": 10
          },
          "includeDescription": {
            "title": "Include full description",
            "type": "boolean",
            "description": "Save the full job description text. Turn off for a smaller, faster dataset.",
            "default": true
          },
          "includeHighlights": {
            "title": "Include job highlights",
            "type": "boolean",
            "description": "Save Google's Qualifications, Responsibilities and Benefits lists when present.",
            "default": true
          },
          "includeErrorRows": {
            "title": "Include error rows",
            "type": "boolean",
            "description": "When a run finds no jobs at all, also save one error row per failed search explaining why. Error rows are never mixed into successful job data.",
            "default": false
          },
          "onlyNewJobs": {
            "title": "Only new jobs",
            "type": "boolean",
            "description": "For scheduled runs: skip job IDs seen in earlier runs with the same state name. New rows get isNew: true.",
            "default": false
          },
          "stateName": {
            "title": "Alert / state name",
            "type": "string",
            "description": "Separate seen-jobs memory for each alert. Use one name per saved search.",
            "default": "default"
          },
          "startUrls": {
            "title": "Google Jobs URLs",
            "type": "array",
            "description": "Mode=parse URLs only. Paste Google Jobs search links (udm=8 or ibp=htl;jobs) or job share links. Search links keep their own filters; share links return that one job.",
            "items": {
              "type": "string"
            },
            "default": []
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}