{ "openapi": "3.0.1", "info": { "title": "Shine.com Jobs Scraper: India Job Listings by Role and City", "description": "Shine jobs scraper for India job listings: search any role and city, get one clean row per job with salary band, experience, location and description. Shine.com jobs to JSON. Pay per job.", "version": "1.0", "x-build-id": "3Z2glj5QSFzRdEtwR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/titian_fluorite~shine-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-titian_fluorite-shine-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/titian_fluorite~shine-jobs-scraper/runs": { "post": { "operationId": "runs-sync-titian_fluorite-shine-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/titian_fluorite~shine-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-titian_fluorite-shine-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": "array", "description": "Job titles or skills to search for on Shine.com, one per line. Each keyword becomes one search, and each keyword is searched in every city you list below. Leave this empty only if you are giving Shine search URLs instead.", "items": { "type": "string" } }, "locations": { "title": "Cities", "type": "array", "description": "Optional. Indian cities to search in, one per line, for example Bangalore, Mumbai, Delhi NCR, Hyderabad, Pune or Chennai. Leave this empty to search all of India. A city Shine does not recognise is skipped with a warning rather than quietly returning all India results.", "default": [], "items": { "type": "string" } }, "searchUrls": { "title": "Shine search URLs", "type": "array", "description": "Optional. Paste Shine job search addresses to use exactly as they are, for example https://www.shine.com/job-search/python-developer-jobs-in-bangalore. Only job search pages are accepted, and an address with a query string is refused because robots.txt disallows several of them.", "default": [], "items": { "type": "string" } }, "maxJobsPerSearch": { "title": "Maximum jobs per search", "minimum": 0, "type": "integer", "description": "How many jobs to collect from each search before moving on. Shine returns 20 jobs per page. Set 0 to take everything Shine will serve, up to a safety cap of 250 pages per search. A run collects at most 50 searches and 20,000 jobs in total. Every job row you receive is billed.", "default": 100 }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Optional. Keep only jobs posted in the last N days. Leave empty to keep everything Shine returns." }, "experienceMin": { "title": "Minimum experience", "minimum": 0, "maximum": 80, "type": "integer", "description": "Optional. Keep only jobs whose published experience band reaches at least this many years. A job that publishes no band is kept." }, "experienceMax": { "title": "Maximum experience", "minimum": 0, "maximum": 80, "type": "integer", "description": "Optional. Keep only jobs whose published experience band starts at or below this many years. A job that publishes no band is kept." }, "includeDescription": { "title": "Include the job description", "type": "boolean", "description": "Add the full job description as cleaned HTML and as plain text. Descriptions are long, so turning this off makes the dataset several times smaller.", "default": true }, "maxConcurrency": { "title": "Maximum concurrent requests", "minimum": 1, "maximum": 2, "type": "integer", "description": "How many requests may be in flight at once. Capped at 2 on purpose: this Actor reads a public site politely and will not be turned into a hammer.", "default": 2 } } }, "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 } } } } } } } } } }