{
  "openapi": "3.0.1",
  "info": {
    "title": "Job Posting AI Enricher – Skills, Seniority & Salary",
    "description": "Enrich job postings from any job scraper dataset, CSV or JSON with AI: skills, tech stack, seniority, years of experience, salary normalised to annual, remote/hybrid/onsite, visa sponsorship, education, contract type, languages and a summary. No API key. $2 per 1,000 jobs + LLM tokens.",
    "version": "0.1",
    "x-build-id": "9sIuPsaf4bauOIIIH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/gazidev~job-posting-enricher/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-gazidev-job-posting-enricher",
        "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/gazidev~job-posting-enricher/runs": {
      "post": {
        "operationId": "runs-sync-gazidev-job-posting-enricher",
        "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/gazidev~job-posting-enricher/run-sync": {
      "post": {
        "operationId": "run-sync-gazidev-job-posting-enricher",
        "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": {
          "datasetIds": {
            "title": "Job datasets (from any job scraper)",
            "type": "array",
            "description": "Datasets with job postings, e.g. the output of a LinkedIn, Indeed, Greenhouse, Lever, Workday or career-site scraper run. In an integration use {{resource.defaultDatasetId}}. All sources are combined. Remove the example jobs below when you use your own data."
          },
          "fileUrls": {
            "title": "File URLs (CSV, XLSX, JSON)",
            "type": "array",
            "description": "Public URLs of CSV, TSV, XLSX, JSON or JSON Lines files with one job per row. Google Sheets ('Anyone with the link'), Google Drive, Dropbox and GitHub links are converted to direct downloads.",
            "items": {
              "type": "string"
            }
          },
          "jobs": {
            "title": "Or paste job postings (JSON)",
            "type": "array",
            "description": "A JSON array of job objects. Any field names work: title/description/company/location/salary are detected automatically."
          },
          "maxItems": {
            "title": "Max jobs",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many jobs (0 = all). You pay per enriched job, so start small.",
            "default": 1000
          },
          "fields": {
            "title": "Fields to extract",
            "type": "array",
            "description": "Fewer fields = fewer output tokens = cheaper LLM cost. Empty = all fields.",
            "items": {
              "type": "string",
              "enum": [
                "seniority",
                "jobFunction",
                "skills",
                "experience",
                "education",
                "employmentType",
                "workplace",
                "visa",
                "salary",
                "languages",
                "redFlags",
                "summary"
              ],
              "enumTitles": [
                "Seniority (intern ... executive)",
                "Job function / family",
                "Skills: required, nice-to-have, soft skills, tech stack",
                "Years of experience (min/max)",
                "Education level",
                "Employment type (full-time, contract, ...)",
                "Remote / hybrid / onsite + remote regions",
                "Visa sponsorship (yes/no/unknown + quote)",
                "Salary min/max/currency/period + annualised",
                "Posting language + language requirements",
                "Red flags",
                "1-2 sentence summary"
              ]
            },
            "default": [
              "seniority",
              "jobFunction",
              "skills",
              "experience",
              "education",
              "employmentType",
              "workplace",
              "visa",
              "salary",
              "languages",
              "redFlags",
              "summary"
            ]
          },
          "taxonomy": {
            "title": "Skill names",
            "enum": [
              "free",
              "esco",
              "onet"
            ],
            "type": "string",
            "description": "How skills are named. ESCO / O*NET labels make skills comparable across postings and countries.",
            "default": "free"
          },
          "summaryLanguage": {
            "title": "Summary language",
            "type": "string",
            "description": "Language of summary and jobFunction. Skill names stay in English.",
            "default": "English"
          },
          "titleField": {
            "title": "Title field",
            "type": "string",
            "description": "Leave empty to auto-detect (title, jobTitle, positionName, ...). Dot paths work, e.g. job.title."
          },
          "descriptionField": {
            "title": "Description field(s)",
            "type": "string",
            "description": "Leave empty to auto-detect (description_text, descriptionText, description, descriptionHtml, ...). Several fields: comma-separated, e.g. descriptionText,requirementsText. HTML is stripped."
          },
          "companyField": {
            "title": "Company field",
            "type": "string",
            "description": "Leave empty to auto-detect (company, companyName, organization, employer, ...)."
          },
          "locationField": {
            "title": "Location field",
            "type": "string",
            "description": "Leave empty to auto-detect (location, locations, formattedLocation, city, ...)."
          },
          "salaryField": {
            "title": "Salary field",
            "type": "string",
            "description": "Leave empty to auto-detect (salary, salary_summary, salaryText, compensation, ...). Structured salary_min/salary_max columns are used as hints automatically."
          },
          "model": {
            "title": "Model",
            "enum": [
              "google/gemini-2.5-flash-lite",
              "openai/gpt-4.1-nano",
              "openai/gpt-4o-mini",
              "google/gemini-2.5-flash",
              "openai/gpt-5.4-mini",
              "anthropic/claude-haiku-5.5"
            ],
            "type": "string",
            "description": "LLM used through Apify's OpenRouter Actor; tokens are billed to your Apify account (no API key needed). A typical posting costs ~$0.0002-0.0004 in tokens with the default model.",
            "default": "google/gemini-2.5-flash-lite"
          },
          "customModel": {
            "title": "Custom OpenRouter model ID",
            "type": "string",
            "description": "Optional: any model ID from openrouter.ai/models. Overrides the select above."
          },
          "maxDescriptionChars": {
            "title": "Max description characters",
            "minimum": 500,
            "maximum": 30000,
            "type": "integer",
            "description": "Longer descriptions are truncated to keep token cost predictable (6,000 chars = ~1,500 tokens).",
            "default": 6000
          },
          "concurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Jobs sent to the model at the same time. Rate limits are retried automatically.",
            "default": 10
          },
          "includeOriginal": {
            "title": "Include original job record",
            "type": "boolean",
            "description": "Adds the full source row under 'original' (larger dataset). jobTitle, company, location, jobUrl and sourceId are always included for joining.",
            "default": false
          },
          "includeUsage": {
            "title": "Add model and token columns",
            "type": "boolean",
            "description": "Adds aiModel, aiTokens and descriptionChars to every job.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}