{
  "openapi": "3.0.1",
  "info": {
    "title": "XING Jobs Scraper | Every Job, Salaries & Recruiter Contacts",
    "description": "Scrape XING jobs in Germany, Austria and Switzerland: every job in a search, past the 1,000-job limit. Full description, salary range or XING estimate, recruiter emails and phones. Companies mode: profiles of the employers hiring, with size, industry, HQ and website. Incremental alerts.",
    "version": "0.1",
    "x-build-id": "tnCFr4MOcHrvumqJ5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/corvuslab~xing-jobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-corvuslab-xing-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/corvuslab~xing-jobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-corvuslab-xing-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/corvuslab~xing-jobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-corvuslab-xing-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": {
          "searchTerms": {
            "title": "🔑 Search terms",
            "type": "array",
            "description": "Job titles, skills or companies, e.g. \"Softwareentwickler\", \"Marketing Manager\" or \"SAP\". Each term is its own search. Leave empty to list every job.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "📍 Locations",
            "type": "array",
            "description": "Cities to search in, e.g. \"Berlin\", \"München\", \"Wien\" or \"Zürich\". Leave empty to search everywhere.",
            "items": {
              "type": "string"
            }
          },
          "radiusKm": {
            "title": "🎯 Radius",
            "enum": [
              "default",
              "0",
              "10",
              "20",
              "30",
              "50",
              "75",
              "100",
              "150",
              "200"
            ],
            "type": "string",
            "description": "How far around each location to search. Only used together with a location.",
            "default": "default"
          },
          "startUrls": {
            "title": "📋 Start URLs",
            "type": "array",
            "description": "Paste XING job search URLs (xing.com/jobs/search?keywords=…) or single job URLs (xing.com/jobs/berlin-software-engineer-158507933). Search URLs keep the filters you set on the site. When given, they replace the search terms above.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxResults": {
            "title": "🔢 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of jobs to return across all searches. Set 0 for no limit — big searches are read in full, even past what the site shows in one search.",
            "default": 50
          },
          "employmentTypes": {
            "title": "💼 Employment type",
            "type": "array",
            "description": "Keep only these employment types.",
            "items": {
              "type": "string",
              "enum": [
                "full_time",
                "part_time",
                "freelance",
                "student",
                "temporary",
                "seasonal",
                "volunteer"
              ],
              "enumTitles": [
                "Full-time",
                "Part-time",
                "Freelance / self-employed",
                "Student job / internship",
                "Temporary",
                "Seasonal",
                "Volunteer"
              ]
            }
          },
          "careerLevels": {
            "title": "📈 Career level",
            "type": "array",
            "description": "Keep only these seniority levels.",
            "items": {
              "type": "string",
              "enum": [
                "student_intern",
                "entry_level",
                "professional",
                "manager",
                "executive",
                "senior_executive"
              ],
              "enumTitles": [
                "Student / intern",
                "Entry level",
                "Professional / experienced",
                "Manager / supervisor",
                "Executive (VP, SVP …)",
                "Senior executive (CEO, CFO …)"
              ]
            }
          },
          "disciplines": {
            "title": "🧩 Discipline",
            "type": "array",
            "description": "Keep only jobs in these professional fields.",
            "items": {
              "type": "string",
              "enum": [
                "it_software",
                "engineering_technical",
                "sales_commerce",
                "marketing_advertising",
                "finance_accounting",
                "health_medical_social",
                "consulting",
                "management",
                "project_management",
                "product_management",
                "hr",
                "administration",
                "customer_service",
                "purchasing_logistics",
                "production_manufacturing",
                "process_planning_qa",
                "analysis_statistics",
                "teaching_research",
                "design_architecture",
                "pr_journalism",
                "legal",
                "other"
              ],
              "enumTitles": [
                "IT and software development",
                "Engineering and technical",
                "Sales and commerce",
                "Marketing and advertising",
                "Finance, accounting & controlling",
                "Health, medical and social",
                "Consulting",
                "Management and corporate development",
                "Project management",
                "Product management",
                "HR",
                "Administration",
                "Customer service",
                "Purchasing, materials management & logistics",
                "Production and manufacturing",
                "Process planning & QA",
                "Analysis and statistics",
                "Teaching, R&D",
                "Graphic design and architecture",
                "PR and journalism",
                "Legal",
                "Other"
              ]
            }
          },
          "remoteOptions": {
            "title": "🏠 Workplace",
            "type": "array",
            "description": "Keep only fully remote, hybrid or on-site jobs.",
            "items": {
              "type": "string",
              "enum": [
                "full_remote",
                "hybrid",
                "on_site"
              ],
              "enumTitles": [
                "Fully remote",
                "Hybrid",
                "On-site"
              ]
            }
          },
          "postedWithin": {
            "title": "🗓️ Posted within",
            "enum": [
              "any",
              "24h",
              "7d",
              "30d"
            ],
            "type": "string",
            "description": "Keep only jobs published recently.",
            "default": "any"
          },
          "salaryMin": {
            "title": "💶 Minimum yearly salary",
            "minimum": 0,
            "type": "integer",
            "description": "Keep jobs whose salary reaches at least this much per year (EUR). XING applies this loosely and counts its own salary estimates too."
          },
          "salaryMax": {
            "title": "💶 Maximum yearly salary",
            "minimum": 0,
            "type": "integer",
            "description": "Keep jobs whose salary starts at or below this much per year (EUR)."
          },
          "countries": {
            "title": "🌍 Countries",
            "type": "array",
            "description": "Keep only jobs located in these countries. Combine with a location for the fastest runs.",
            "items": {
              "type": "string",
              "enum": [
                "DE",
                "AT",
                "CH"
              ],
              "enumTitles": [
                "Germany",
                "Austria",
                "Switzerland"
              ]
            }
          },
          "industries": {
            "title": "🏭 Industries",
            "type": "array",
            "description": "Keep only jobs whose industry contains one of these words, e.g. \"Banking\", \"Automotive\" or \"Pharma\" (matches the job's or the company's industry).",
            "items": {
              "type": "string"
            }
          },
          "requireContact": {
            "title": "📇 Require contact details",
            "enum": [
              "off",
              "email",
              "phone",
              "either",
              "both"
            ],
            "type": "string",
            "description": "off = keep everything; email / phone = require that channel; either = at least one; both = email and phone. Skipped jobs are not charged.",
            "default": "off"
          },
          "includeDetails": {
            "title": "🔬 Include full details",
            "type": "boolean",
            "description": "Add the full job description, XING's summary, keywords and the contacts found in the posting. Turn off for the smallest records.",
            "default": true
          },
          "descriptionFormat": {
            "title": "📝 Description format",
            "enum": [
              "all",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "Which representation(s) of the job description to include.",
            "default": "all"
          },
          "descriptionMaxLength": {
            "title": "✂️ Max description length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full length.",
            "default": 0
          },
          "language": {
            "title": "🗣️ Label language",
            "enum": [
              "en",
              "de"
            ],
            "type": "string",
            "description": "Language of labels such as employment type, career level, discipline and country. Job texts stay as the employer wrote them.",
            "default": "en"
          },
          "compact": {
            "title": "📦 Compact records",
            "type": "boolean",
            "description": "Emit only the core fields. Ideal for AI agents and MCP clients.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "🧹 Drop empty fields",
            "type": "boolean",
            "description": "Remove null, empty-string and empty-array fields from each record.",
            "default": false
          },
          "incrementalMode": {
            "title": "♻️ Incremental mode",
            "type": "boolean",
            "description": "Track jobs between runs and tag every record with a changeType (NEW / UPDATED / REAPPEARED / UNCHANGED / EXPIRED). Unchanged jobs are skipped and cost nothing.",
            "default": false
          },
          "stateKey": {
            "title": "🗝️ State key",
            "type": "string",
            "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings."
          },
          "emitUnchanged": {
            "title": "🔁 Include unchanged jobs",
            "type": "boolean",
            "description": "Also emit jobs that have not changed since the previous run.",
            "default": false
          },
          "emitExpired": {
            "title": "🗑️ Include expired jobs",
            "type": "boolean",
            "description": "Emit a record for each job that was there last run and is gone now. Only reported by runs that read the whole search.",
            "default": false
          },
          "skipReposts": {
            "title": "🚫 Skip reposts",
            "type": "boolean",
            "description": "Leave out jobs that look like a re-post of one seen before (same title, company and location under a new id).",
            "default": false
          },
          "telegramToken": {
            "title": "💬 Telegram bot token",
            "type": "string",
            "description": "Bot token from @BotFather."
          },
          "telegramChatId": {
            "title": "🆔 Telegram chat ID",
            "type": "string",
            "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"."
          },
          "slackWebhookUrl": {
            "title": "💼 Slack webhook URL",
            "type": "string",
            "description": "Slack incoming-webhook URL."
          },
          "discordWebhookUrl": {
            "title": "🎮 Discord webhook URL",
            "type": "string",
            "description": "Discord incoming-webhook URL."
          },
          "webhookUrl": {
            "title": "🪝 Webhook URL",
            "type": "string",
            "description": "Any HTTPS endpoint. Receives a JSON POST with the matched jobs — works with n8n, Make and Zapier."
          },
          "webhookHeaders": {
            "title": "🧾 Webhook headers",
            "type": "object",
            "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}."
          },
          "notificationLimit": {
            "title": "🔢 Jobs per notification",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many jobs to list in each notification message.",
            "default": 5
          },
          "notifyOnlyChanges": {
            "title": "🆕 Notify only about changes",
            "type": "boolean",
            "description": "With incremental mode on, notify only about NEW, UPDATED and REAPPEARED jobs.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy configuration",
            "type": "object",
            "description": "Optional. The actor works without a proxy; turn one on only if your runs are refused.",
            "default": {
              "useApifyProxy": false
            }
          },
          "maxRequestRetries": {
            "title": "🔄 Max request retries",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "How many times to retry a failed request before giving up on it.",
            "default": 3
          },
          "ignoreUrlFailures": {
            "title": "⏭️ Ignore URL failures",
            "type": "boolean",
            "description": "Skip start URLs that cannot be interpreted instead of failing the whole run.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}