{ "openapi": "3.0.1", "info": { "title": "Hospitality Jobs Scraper · 4 Boards, One Schema", "description": "Hospitality jobs: hotel and restaurant job postings from L'Hôtellerie Restauration (France), HOGAPAGE and Gastrojobs (Germany) and Hosco (worldwide) in one run, one schema, deduplicated across sources, no login.", "version": "0.1", "x-build-id": "bq94J2ptalwRFrdIS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bibian~hospitality-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bibian-hospitality-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/bibian~hospitality-jobs-scraper/runs": { "post": { "operationId": "runs-sync-bibian-hospitality-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/bibian~hospitality-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-bibian-hospitality-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": { "keywords": { "title": "Keywords", "type": "string", "description": "Job title or trade, for example \"chef de cuisine\" or \"Koch\". Leave empty to get every posting." }, "location": { "title": "Location", "type": "string", "description": "City or region, for example \"Paris\" or \"Berlin\". Leave empty for all locations." }, "countries": { "title": "Countries", "type": "array", "description": "Keep only the sources covering these countries. \"Worldwide\" keeps Hosco regardless of the other countries chosen, since it is not tied to a single one.", "items": { "type": "string", "enum": [ "FR", "DE", "GLOBAL" ], "enumTitles": [ "France", "Germany", "Worldwide (Hosco)" ] }, "default": [ "FR", "DE", "GLOBAL" ] }, "sources": { "title": "Sources", "type": "array", "description": "Job boards to query in this run.", "items": { "type": "string", "enum": [ "lhotellerie", "hogapage", "gastrojobs", "hosco" ], "enumTitles": [ "L'Hôtellerie Restauration", "HOGAPAGE", "Gastrojobs", "Hosco" ] }, "default": [ "lhotellerie", "hogapage", "gastrojobs", "hosco" ] }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep only postings published in the last N days. Use 1 for a daily monitoring run. Leave empty for no limit." }, "remote": { "title": "Remote work", "enum": [ "any", "remote", "hybrid", "onsite" ], "type": "string", "description": "Keep only postings with this remote policy.", "default": "any" }, "maxItems": { "title": "Maximum number of postings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The run stops once this many postings are saved, across all sources combined. Kept low by default: Hosco's robots.txt imposes a 10-second delay between requests (politeness rule), which caps how many of its postings fit in one run.", "default": 20 }, "includeDescriptions": { "title": "Include full descriptions", "type": "boolean", "description": "Add the job description as plain text.", "default": true }, "onlyNew": { "title": "Only new results", "type": "boolean", "description": "For scheduled runs. Skip the results that an earlier run of this same search already delivered, so each run returns, and charges, only what is new. The memory is kept in a key-value store of your account named \"only-new-memory-bibian-\" followed by the ID of this Actor.", "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 } } } } } } } } } }