{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Jobs Scraper",
    "description": "Deep search, salaries and clean apply links: 50–100+ Google Jobs per search (past the 10-job limit), salary parsed into numbers, real posted dates, full descriptions, apply links with mismatches filtered out, new-jobs-only mode. Free during launch.",
    "version": "1.0",
    "x-build-id": "k2KfCpYliFUqNmeAR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bightsystems~google-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bightsystems-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/bightsystems~google-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-bightsystems-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/bightsystems~google-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-bightsystems-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": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "Job titles or keywords, one per line, exactly as you'd type them into Google Jobs. You can include a place (\"nurse Chicago IL\") or use Locations below. Each query × location is one search. Optional if you paste Google Jobs URLs below (clear the example queries if you only want the URLs).",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations (optional)",
            "type": "array",
            "description": "Cities, regions or countries, e.g. \"Austin, TX\" or \"London\". Every query is searched in every location. Leave empty to search the whole country, or to use places already written into your queries.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Google Jobs URLs (optional)",
            "type": "array",
            "description": "Paste Google Jobs search URLs (the Jobs tab, `udm=8`, or older `ibp=htl;jobs` links). We read the search text, country (gl or domain), language (hl) and date/employment-type chips from each URL. Depth, filters and output settings below still apply. Non-Google URLs are skipped with a note.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "US",
              "GB",
              "CA",
              "IN",
              "DE",
              "AT",
              "CH",
              "FR",
              "BE",
              "NL",
              "ES",
              "IT",
              "PT",
              "BR",
              "MX",
              "AR",
              "CO",
              "CL",
              "PE",
              "ZA",
              "NG",
              "KE",
              "GH",
              "EG",
              "AE",
              "SA",
              "PK",
              "BD",
              "SG",
              "MY",
              "PH",
              "ID",
              "JP",
              "HK",
              "GR",
              "DK",
              "AU",
              "NZ",
              "IE",
              "KR",
              "PL",
              "CZ",
              "TR",
              "UA",
              "IL",
              "NO",
              "SE",
              "FI",
              "EE",
              "LV",
              "LT"
            ],
            "type": "string",
            "description": "Which Google Jobs market to search (sets the Google domain, region and currency). Google Jobs does not serve listings in Australia, New Zealand, Ireland, South Korea, Poland, Czechia, Turkey, Ukraine, Israel, the Nordics or the Baltics — runs for those stop immediately at no charge.",
            "default": "US"
          },
          "language": {
            "title": "Language",
            "enum": [
              "auto",
              "en",
              "de",
              "fr",
              "es",
              "pt",
              "it",
              "nl",
              "ja",
              "id",
              "el",
              "da"
            ],
            "type": "string",
            "description": "Interface language for Google and for the depth slices. \"Auto\" uses the country's main language (German for DE/AT/CH, English for US/GB/IN…).",
            "default": "auto"
          },
          "datePosted": {
            "title": "Date posted",
            "enum": [
              "any",
              "today",
              "3days",
              "week",
              "month"
            ],
            "type": "string",
            "description": "Only return jobs posted within this window (uses Google Jobs' own date filter).",
            "default": "any"
          },
          "remoteFilter": {
            "title": "Remote",
            "enum": [
              "any",
              "remoteOnly",
              "excludeRemote"
            ],
            "type": "string",
            "description": "\"Remote only\" asks Google for remote jobs and keeps only jobs marked remote (location \"Anywhere\", or remote in title/description). \"Exclude remote\" drops remote jobs.",
            "default": "any"
          },
          "employmentType": {
            "title": "Employment type",
            "enum": [
              "any",
              "FULLTIME",
              "PARTTIME",
              "CONTRACTOR",
              "INTERN",
              "TEMPORARY"
            ],
            "type": "string",
            "description": "Restrict to one employment type (uses Google Jobs' own filter). For several types at once use \"Employment types\" below.",
            "default": "any"
          },
          "employmentTypes": {
            "title": "Employment types (several at once)",
            "uniqueItems": true,
            "type": "array",
            "description": "Pick one or more. Each type is searched separately and merged without duplicates, which also widens coverage (each type returns a largely different set of jobs). Jobs whose type Google shows as something else are removed (jobs with no type shown are kept).",
            "items": {
              "type": "string",
              "enum": [
                "FULLTIME",
                "PARTTIME",
                "CONTRACTOR",
                "INTERN",
                "TEMPORARY"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Contractor",
                "Internship",
                "Temporary"
              ]
            }
          },
          "postedWithinHours": {
            "title": "Posted within the last X hours (optional)",
            "minimum": 1,
            "maximum": 8760,
            "type": "integer",
            "description": "Keep only jobs posted at most this many hours ago (e.g. 12 or 48). We also ask Google for the matching date window. Jobs without a posted date are removed when this is set."
          },
          "salaryOnly": {
            "title": "Only jobs with a salary",
            "type": "boolean",
            "description": "Keep only jobs that show a salary parsed into numbers.",
            "default": false
          },
          "minAnnualSalary": {
            "title": "Minimum annual salary (optional)",
            "minimum": 1,
            "type": "integer",
            "description": "Keep only jobs whose annualized salary (top of the range) is at least this amount, in the job's own currency (e.g. 80000 for USD 80K in the US). Jobs without a salary are removed when this is set."
          },
          "includeCompanies": {
            "title": "Only these companies (optional)",
            "type": "array",
            "description": "Keep only jobs whose company name contains one of these words (case-insensitive), e.g. \"Amazon\", \"Siemens\".",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude these companies (optional)",
            "type": "array",
            "description": "Drop jobs whose company name contains one of these words (case-insensitive), e.g. staffing agencies like \"Robert Half\".",
            "items": {
              "type": "string"
            }
          },
          "depth": {
            "title": "Search depth",
            "enum": [
              "single",
              "standard",
              "deep"
            ],
            "type": "string",
            "description": "Google shows only ~10 jobs per search. We go deeper by re-running each search with Google's own filter phrases (full time, part time, posted this week…) and merging the results without duplicates. Single: 1 request, ~10 jobs. Standard: up to 9 requests, typically 40–70 jobs. Deep: up to 21 requests, typically 80–130+ jobs on broad searches. You pay per job returned, not per request.",
            "default": "standard"
          },
          "maxJobsPerQuery": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop a search once this many unique jobs are found. A search is one query × one location.",
            "default": 100
          },
          "maxJobsTotal": {
            "title": "Max jobs per run",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap across the whole run. 0 = no cap (you can also set a maximum cost per run in Apify).",
            "default": 0
          },
          "onlyNewJobs": {
            "title": "Only new jobs since last run",
            "type": "boolean",
            "description": "Remember every job this Actor has returned (in a named key-value store in your account) and skip jobs already returned by earlier runs with the same state key. Ideal for scheduled daily alerts: you only pay for new jobs. Jobs are remembered for 90 days.",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name of the memory used by \"Only new jobs\". Use a different key per monitor (e.g. \"nurses-chicago\") so monitors don't hide each other's jobs.",
            "default": "default"
          },
          "includeDescription": {
            "title": "Include full description",
            "type": "boolean",
            "description": "Full job description as plain text.",
            "default": true
          },
          "includeDescriptionHtml": {
            "title": "Include description HTML",
            "type": "boolean",
            "description": "Also return the description with its original line breaks/markup.",
            "default": false
          },
          "includeHighlights": {
            "title": "Include qualifications / responsibilities / benefits",
            "type": "boolean",
            "description": "Google's structured highlight bullets, when the job has them.",
            "default": true
          },
          "outputFormat": {
            "title": "Output format",
            "enum": [
              "full",
              "compact",
              "flat"
            ],
            "type": "string",
            "description": "Full: every field, lists as arrays (best for API/JSON). Compact: no description, highlights or link lists — small and fast. Flat: lists joined into text so CSV/Excel/Google Sheets exports have one row per job.",
            "default": "full"
          },
          "applyLinkFilter": {
            "title": "Apply-link filter",
            "enum": [
              "standard",
              "strict",
              "off"
            ],
            "type": "string",
            "description": "Google merges similar postings, so a job's link list can include links to other jobs. Standard: drop links whose URL clearly names a different job (the job's own posting link is always kept). Strict: keep only the job's own posting link plus links whose URL confirms the same title or employer — fewer links, fewer wrong ones. Off: return every link Google lists, each labelled with its match status.",
            "default": "standard"
          },
          "verifyPrimaryApplyLink": {
            "title": "Verify primary apply link live",
            "type": "boolean",
            "description": "Open each job's primary apply link and confirm the page title matches the job (switching to the next good link if not). Slower; many job boards block automated visits, which are reported as \"blocked\" rather than failed.",
            "default": false
          },
          "stripTrackingParams": {
            "title": "Remove tracking parameters",
            "type": "boolean",
            "description": "Remove utm_* parameters Google adds to apply links.",
            "default": true
          },
          "dedupeAcrossQueries": {
            "title": "Remove duplicates across searches",
            "type": "boolean",
            "description": "If the same job (same title, company and location) is found by two of your searches, return it once.",
            "default": true
          },
          "maxConcurrency": {
            "title": "Max parallel requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many Google requests run at the same time.",
            "default": 10
          },
          "requestTimeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 15,
            "maximum": 180,
            "type": "integer",
            "description": "Give up on one Google request after this long and retry.",
            "default": 60
          },
          "maxRetries": {
            "title": "Max retries per request",
            "minimum": 0,
            "maximum": 6,
            "type": "integer",
            "description": "Retries with exponential backoff for timeouts, blocks and bad pages. If a request still fails, the run continues and keeps everything found so far.",
            "default": 3
          },
          "healthCheck": {
            "title": "Health-check mode",
            "type": "boolean",
            "description": "For scheduled monitoring. After the searches, score the results against quality thresholds (jobs per search, field fill rates, failed requests, live check of a sample of primary apply links). The run is marked FAILED, with the reasons in the status message, if any threshold is missed. A report is saved to the HEALTH record in the key-value store.",
            "default": false
          },
          "healthThresholds": {
            "title": "Health thresholds (optional)",
            "type": "object",
            "description": "Override any default threshold, e.g. {\"minSearchesWith8PlusPct\": 90, \"minDescriptionPct\": 90, \"minPrimaryLinkConfirmedPct\": 80}. Keys: minSearchesWith8PlusPct, minTitleCompanyPct, minDescriptionPct, minApplyUrlPct, minPostedDatePct, minEmploymentTypePct, minSalaryParsedPct, maxFailedRequestPct, minPrimaryLinkConfirmedPct, minReadableLinkChecks."
          },
          "healthLinkSample": {
            "title": "Apply links to check live",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "How many random primary apply links the health check opens to confirm the page matches the job. These checks use no proxy and add no proxy cost.",
            "default": 40
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}