{
  "openapi": "3.0.1",
  "info": {
    "title": "JobTeaser Job Scraper",
    "description": "Discover the JobTeaser Job Scraper, your efficient tool for extracting job postings and internship offers from JobTeaser. This lightweight actor is designed for quick and easy scraping. For optimal performance and to avoid blocks, using residential proxies is highly recommended.",
    "version": "0.0",
    "x-build-id": "NKQ7CK4bHGCVZKWgE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/shahidirfan~JobTeaser-Job-Scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-shahidirfan-JobTeaser-Job-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/shahidirfan~JobTeaser-Job-Scraper/runs": {
      "post": {
        "operationId": "runs-sync-shahidirfan-JobTeaser-Job-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/shahidirfan~JobTeaser-Job-Scraper/run-sync": {
      "post": {
        "operationId": "run-sync-shahidirfan-JobTeaser-Job-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": {
          "url": {
            "title": "JobTeaser search URL",
            "type": "string",
            "description": "Optional JobTeaser jobs URL. The actor extracts supported filters from clean, messy, or encoded JobTeaser job-search URLs before applying direct inputs."
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Job search keyword(s), for example 'admin', 'developer', or 'marketing'."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Location filter, for example 'Paris', 'Germany', or 'Remote'."
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "fr",
              "de",
              "es",
              "it",
              "nl",
              "pl",
              "pt",
              "sv",
              "da",
              "fi",
              "no",
              "cs",
              "ca",
              "gl"
            ],
            "type": "string",
            "description": "Language for job listings. Only jobs in this language will be scraped.",
            "default": "en"
          },
          "posted_within": {
            "title": "Posted within",
            "enum": [
              "any",
              "24h",
              "7d",
              "30d"
            ],
            "type": "string",
            "description": "Filter jobs posted within the specified time period.",
            "default": "any"
          },
          "jobTypes": {
            "title": "Job types",
            "type": "array",
            "description": "Optional JobTeaser contract type filter using the live supported values from the search index.",
            "items": {
              "type": "string",
              "enum": [
                "internship",
                "cdi",
                "alternating",
                "voluntariat",
                "part_time",
                "cdd",
                "werkstudent",
                "graduate_program",
                "thesis",
                "master_thesis",
                "volunteering",
                "apprenticeship",
                "freelance",
                "vie",
                "project",
                "curricular_internship",
                "duales_studium",
                "work_placement",
                "extra_curricular_intership",
                "civic_service",
                "company_inside",
                "search_project",
                "gopro_internship",
                "scientific_project",
                "berufsbegleitendes_studium",
                "contratto_a_progetto",
                "probationary_year",
                "mba_internship",
                "training_contract",
                "scientific_and_cultural_projects"
              ],
              "enumTitles": [
                "Stage / Internship",
                "CDI",
                "Alternance",
                "Volontariat",
                "Part-time / Student Job",
                "CDD",
                "Werkstudent",
                "Graduate Program",
                "Research / Thesis",
                "Master Thesis",
                "Volunteering",
                "Apprenticeship",
                "Freelance",
                "VIE",
                "Project",
                "Curricular Internship",
                "Duales Studium",
                "Work Placement",
                "Extra-curricular Internship",
                "Civic Service",
                "Internal Opportunity",
                "Search Project",
                "GoPro Internship",
                "Scientific Project",
                "Part-time Study Program",
                "Contratto a Progetto",
                "Probationary Year",
                "MBA Internship",
                "Training Contract",
                "Scientific and Cultural Projects"
              ]
            }
          },
          "results_wanted": {
            "title": "Maximum number of jobs",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of jobs to collect.",
            "default": 20
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Residential proxies are recommended for stable collection."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}