{ "openapi": "3.0.1", "info": { "title": "JobTeaser Scraper | $0.8 / 1k | Fast & Reliable", "description": "Extract structured JobTeaser job listings with company details, locations, contract types, signals, deadlines, and descriptions. Built for enterprise-grade hiring intelligence, early-career market analysis and automated recruiting or analytics pipelines.", "version": "0.0", "x-build-id": "dESybSbc52OJzT99w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~jobteaser-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-jobteaser-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/fatihtahta~jobteaser-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-jobteaser-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/fatihtahta~jobteaser-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-jobteaser-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": { "listing_language": { "title": "Set the JobTeaser Site Language", "enum": [ "fr", "da", "de", "es", "nl", "en" ], "type": "string", "description": "Select the language JobTeaser should use during the run. This changes the site interface and listing labels you see while scraping, but it does not filter jobs by spoken-language requirement.", "default": "en" }, "queries": { "title": "Enter Keywords to Find Matching Roles", "type": "string", "description": "Enter one search term such as a job title, skill, employer name, or career area. This keyword search uses the location and any filters you set below." }, "location": { "title": "Choose Where to Search", "type": "string", "description": "Enter a city, region, or country such as `Paris`, `Lyon`, or `Barcelona, Spain`. Use this with `queries` to collect openings from a specific area." }, "radius": { "title": "Set the Search Radius Around That Location", "enum": [ "5", "10", "20", "30", "50" ], "type": "string", "description": "Choose how far from the selected location results can appear. Smaller distances keep the search local, while larger ones widen coverage to nearby areas.", "default": "30" }, "abroad_only": { "title": "Show Only International Opportunities", "type": "boolean", "description": "Turn this on to keep only listings marked as international on JobTeaser. This is useful for cross-border roles, placements abroad, or globally oriented programs.", "default": false }, "candidacy_type": { "title": "Keep Only Easy-Apply Listings", "enum": [ "INTERNAL" ], "type": "string", "description": "Use this to show jobs that can be applied to directly through JobTeaser, without sending candidates to an external website." }, "company_business_type": { "title": "Choose Employer Types to Include", "type": "array", "description": "Select the organization types you want to collect, such as start-ups, SMEs, large companies, or public and nonprofit institutions.", "items": { "type": "string", "enum": [ "large", "startup", "sme", "ngo_public_lab", "collective" ], "enumTitles": [ "Large company", "Start-up", "SME", "Government/ Charity/ Public Institution/ Other", "Collective" ] } }, "company_sectors": { "title": "Choose Employer Industries", "type": "array", "description": "Select one or more industries to keep only listings from those sectors, such as consulting, software, banking, healthcare, retail, or media.", "items": { "type": "string", "enum": [ "audit", "consultancy", "law", "management_consultancy", "accounting_services", "banking_finance", "insurance", "real_estate", "building_planning", "architecture", "luxury", "retail", "consumer_goods", "energy_utilities", "environment", "agribusiness", "aerospace", "automotive", "chemistry", "defense", "electronics", "materials", "other_industries", "agriculture", "maritime", "it_consultancy_it", "telecoms", "cosmetics", "medicine_pharmaceuticals_health", "recruitment_training", "catering", "transport_logistics", "other_services_to_individuals_and_businesses", "r_d", "engineering", "digital_e_commerce", "media_publishing", "communication_advertising", "public_education", "social_ngo", "tourism_hospitality", "leisure_culture_sports", "other_category" ], "enumTitles": [ "Audit", "Consulting", "Legal", "Management Consulting", "Accounting Services", "Banking / Finance", "Insurance", "Real Estate", "Building / Planning", "Architecture / Design", "Luxury / Fashion", "Retail", "Consumer Goods", "Energy / Utilities / Oil & Gas", "Environment", "Food & Beverage", "Aerospace", "Automotive", "Chemistry", "Defense", "Electronics", "Materials", "Other Industries", "Agriculture / Forest industry", "Maritime / Railway", "IT / IT Consulting / Software", "Telecoms", "Cosmetics", "Medicine / Pharmaceuticals / Health", "Recruitment / Training", "Catering", "Transport / Logistics", "Other services to individuals and businesses", "R&D / Design", "Engineering", "Digital / E-commerce", "Media / Publishing", "Communication / Advertising", "Public / Government / Education / Armed Forces", "Social / NGO / Charity", "Events / Tourism / Hospitality", "Leisure / Culture / Sports", "Other" ] } }, "contract": { "title": "Choose Contract Types", "type": "array", "description": "Filter listings by contract type, such as internships, apprenticeships, full-time roles, freelance work, or graduate programs.", "items": { "type": "string", "enum": [ "internship", "alternating", "cdd", "cdi", "graduate_program", "vie", "part_time", "thesis", "freelance", "master_thesis", "industry_master_job" ], "enumTitles": [ "Internship", "Apprenticeship", "Fixed-term Position", "Full time Position", "Graduate Programme / Job Rotation Programme", "International Graduate Business Placements (VIE)", "Part-time / Student job", "Research / Doctorate", "Freelance/Independent", "Bachelor or Master Thesis", "Industry Master Job" ] } }, "duration": { "title": "Choose Contract Durations", "type": "array", "description": "Select one or more duration ranges to focus on shorter or longer placements. This is especially helpful for internships, apprenticeships, and other fixed-length roles.", "items": { "type": "string", "enum": [ "3", "6", "9", "12", "18", "24", "36" ], "enumTitles": [ "1 - 3 months", "4 - 6 months", "7 - 9 months", "10 - 12 months", "13 - 18 months", "19 - 24 months", "25 - 48+ months" ] } }, "experience": { "title": "Choose Candidate Experience Levels", "type": "array", "description": "Filter for roles aimed at students, recent graduates, or more experienced candidates so your results match the intended profile.", "items": { "type": "string", "enum": [ "young_graduate", "three_to_five_years", "six_to_ten_years", "more_than_ten_years" ], "enumTitles": [ "Student / Recent Graduate", "3 to 5 years", "6 to 10 years", "More than 10 years" ] } }, "language": { "title": "Choose Listing Languages", "type": "array", "description": "Select one or more languages to focus on listings connected to those language selections on JobTeaser. This can help when you want multilingual coverage or a specific language market.", "items": { "type": "string", "enum": [ "en", "fr", "es", "de", "da", "sv", "ca", "cs", "fi", "gl", "it", "no", "nl", "pl", "pt" ], "enumTitles": [ "English", "French", "Spanish", "German", "Danish", "Swedish", "Catalan", "Czech", "Finnish", "Galician", "Italian", "Norwegian", "Dutch", "Polish", "Portuguese" ] } }, "degree": { "title": "Choose Education Levels", "type": "array", "description": "Filter by the study level or degree requirement shown on the listing, from no prerequisite through bachelor's, master's, and doctorate-level roles.", "items": { "type": "string", "enum": [ "1", "6", "2", "3", "4", "5" ], "enumTitles": [ "No level prerequired", "Secondary education, High school level", "Vocational, Under-bachelor, Short-cycle higher education level", "Bachelor level or equivalent", "Master level or equivalent", "Doctorate" ] } }, "start_date": { "title": "Choose Expected Start Dates", "type": "array", "description": "Select one or more start-date windows to focus on immediate openings or future hiring cycles such as internships and graduate programs.", "items": { "type": "string", "enum": [ "0", "2026_03", "2026_04", "2026_05", "2026_06", "2026_07", "2026_08", "2026_09", "2026_10", "2026_11", "2026_12", "2027_01", "2027_02", "2027_03", "2027_04", "2027_05", "2027_06", "2027_07", "2027_08", "2027_09", "2027_10", "2027_11", "2027_12", "2028_01", "2028_02" ], "enumTitles": [ "As soon as possible", "March 2026", "April 2026", "May 2026", "June 2026", "July 2026", "August 2026", "September 2026", "October 2026", "November 2026", "December 2026", "January 2027", "February 2027", "March 2027", "April 2027", "May 2027", "June 2027", "July 2027", "August 2027", "September 2027", "October 2027", "November 2027", "December 2027", "January 2028", "February 2028" ] } }, "remote_types": { "title": "Choose Remote Work Options", "type": "array", "description": "Filter for jobs that allow occasional remote work or full remote arrangements, depending on the flexibility you want in the results.", "items": { "type": "string", "enum": [ "remote_partial", "remote_full" ], "enumTitles": [ "Remote work occasionally allowed", "Full remote work allowed" ] } }, "job_with_impact": { "title": "Show Only Impact-Driven Employers", "type": "boolean", "description": "Turn this on to keep roles from employers featured for social or environmental impact, which is useful for mission-driven job searches and research.", "default": false }, "maximize_coverage": { "title": "Collect the Full Set of Matching Jobs", "type": "boolean", "description": "Turn this on to collect as many matching listings as possible for your search criteria. This is useful when you want more complete results for research, monitoring, reporting, or large job-market snapshots.", "default": true }, "enrich_data": { "title": "Gather full data from every listing", "type": "boolean", "description": "When enabled, the actor visits each individual listing page and gathers additional fields such as description content, company details, dates, and other public attributes. Turn this off when you want faster runs that save only the data visible on the search results pages.", "default": true }, "limit": { "title": "Set the Maximum Number of Listings", "minimum": 1, "type": "integer", "description": "Choose how many jobs to collect for each search. Lower limits are useful for quick tests, while higher limits help you capture broader coverage.", "default": 50000 } } }, "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 } } } } } } } } } }