{ "openapi": "3.0.1", "info": { "title": "Zhaopin Scraper - China Job Listings", "description": "Scrape zhaopin.com job listings across major Chinese cities. Capture salary ranges, HR contact fields, and incremental updates for recurring searches. Use the results to refresh recruiting pipelines without reprocessing unchanged listings.", "version": "0.1", "x-build-id": "hCQnNdQsPJotcJd7R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~zhaopin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-zhaopin-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/blackfalcondata~zhaopin-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-zhaopin-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/blackfalcondata~zhaopin-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-zhaopin-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": { "query": { "title": "🔍 Search Term(s)", "type": "string", "description": "Job search keywords (e.g. \"python\", \"销唎\"). Leave empty to browse all jobs in the selected city." }, "cityId": { "title": "🏙ī¸ City", "type": "string", "description": "City code (e.g. \"530\" for Beijing, \"538\" for Shanghai, \"765\" for Shenzhen). Defaults to Beijing.", "default": "530" }, "maxResults": { "title": "đŸ’¯ Max Results", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum total results. Zhaopin limits to 100 results per query (5 pages × 20). Set 0 for maximum available.", "default": 25 }, "includeDetails": { "title": "📋 Include Full Details", "type": "boolean", "description": "Fetch full job details (description, company profile, address, geo coordinates, HR contact, skills, benefits).", "default": true }, "descriptionMaxLength": { "title": "✂ī¸ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "đŸ“Ļ Compact Output", "type": "boolean", "description": "Core fields only — for AI-agent and MCP workflows.", "default": false }, "incrementalMode": { "title": "â™ģī¸ Incremental Mode", "type": "boolean", "description": "Only return new or changed listings compared to the previous run.", "default": false }, "stateKey": { "title": "🔑 State Key", "type": "string", "description": "Optional stable identifier for the tracked search universe. Leave empty to auto-derive a stable identifier from your search inputs — different keyword/location/filter combinations get isolated state automatically." }, "allowNonIncrementalFallback": { "title": "↩ī¸ Allow Non-Incremental Fallback", "type": "boolean", "description": "If incremental mode is requested but the state store is not accessible on this account, fall back to a non-incremental run instead of failing. Default: fail loudly so missing state is not silently ignored.", "default": false }, "emitUnchanged": { "title": "â™ģī¸ Emit Unchanged", "type": "boolean", "description": "Also emit jobs that have not changed since the last run.", "default": false }, "emitExpired": { "title": "⚰ī¸ Emit Expired", "type": "boolean", "description": "Also emit jobs that have disappeared since the last run.", "default": false }, "skipReposts": { "title": "đŸšĢ Skip Reposts", "type": "boolean", "description": "When incremental, skip jobs whose content matches a previously expired job.", "default": false }, "telegramToken": { "title": "🔑 Telegram Bot Token", "type": "string", "description": "Telegram bot token (from @BotFather)." }, "telegramChatId": { "title": "đŸ’Ŧ Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID. Required when telegramToken is set." }, "discordWebhookUrl": { "title": "🎮 Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL." }, "slackWebhookUrl": { "title": "đŸ’ŧ Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL." }, "whatsappAccessToken": { "title": "📱 WhatsApp Access Token", "type": "string", "description": "WhatsApp Cloud API access token. Recipient must have messaged your business number within last 24h." }, "whatsappPhoneNumberId": { "title": "📞 WhatsApp Phone Number ID", "type": "string", "description": "WhatsApp Business phone-number ID." }, "whatsappTo": { "title": "📲 WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format without +." }, "webhookUrl": { "title": "đŸĒ Generic Webhook URL", "type": "string", "description": "Receives a JSON POST with {metadata, items} after each run." }, "webhookHeaders": { "title": "📋 Webhook Headers", "type": "object", "description": "Optional JSON object of custom headers." }, "notificationLimit": { "title": "📊 Max Jobs Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of jobs included in each notification message (1–20).", "default": 5 }, "notifyOnlyChanges": { "title": "🔄 Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only send notifications for NEW and UPDATED jobs.", "default": false }, "phoneExtractionMode": { "title": "📞 Phone Extraction Mode", "enum": [ "strict", "lenient" ], "type": "string", "description": "Strict (Tel:/+CC prefix only) or Lenient (also bare local numbers).", "default": "strict" }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.", "default": "all" }, "excludeEmptyFields": { "title": "Exclude empty fields from output", "type": "boolean", "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.", "default": false }, "appConnector": { "title": "Send results to Notion (or another connected app)", "type": "string", "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog." }, "mcpIssueTeam": { "title": "Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." } } }, "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 } } } } } } } } } }