{ "openapi": "3.0.1", "info": { "title": "Shine.com Jobs Scraper — 22 Fields, Monitor Mode, No Login", "description": "Scrape live Shine.com (Times Group) job listings: title, company, salary, experience band, location, employment type, skills and full description. Filter by keyword, location, experience, salary and employment type. No login, no browser. Use it as an MCP server in Claude, ChatGPT & AI agents.", "version": "0.1", "x-build-id": "acdGGDbF32V6zhuhO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~shine-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~shine-jobs-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~shine-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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", "required": [ "searchKeywords" ], "properties": { "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One or more job-search keywords, e.g. 'python developer', 'data scientist'. Each keyword is searched separately on Shine.com and results are merged.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City name, e.g. 'Bangalore', 'Mumbai', 'Pune'. Leave blank for all India. Common Indian cities are matched to Shine's internal location filter automatically; other names fall back to Shine's own location search." }, "experienceLevel": { "title": "Experience level", "enum": [ "", "lt1", "1to2", "3to5", "6to8", "9to10", "11to15", "gt15" ], "type": "string", "description": "Years of experience band, as offered by Shine's own filter.", "default": "" }, "salaryRange": { "title": "Salary range (₹ Lakhs / year)", "enum": [ "", "0to2", "3to5", "6to8", "9to12", "13to16", "17to25", "gt25" ], "type": "string", "description": "Annual CTC band, as offered by Shine's own filter.", "default": "" }, "employmentType": { "title": "Employment type", "enum": [ "", "regular", "contractual", "internship", "work-from-home" ], "type": "string", "description": "Employment type, as offered by Shine's own filter.", "default": "" }, "shiftType": { "title": "Shift type", "enum": [ "", "full-time", "part-time" ], "type": "string", "description": "Full-time or part-time, as offered by Shine's own filter.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "freshness" ], "type": "string", "description": "Relevance (Shine's default ranking) or Freshness (newest postings first — useful with Monitor mode).", "default": "relevance" }, "maxJobs": { "title": "Max jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to scrape across all keywords. Hard cap 1000.", "default": 5 }, "includeJobDescription": { "title": "Include full job description", "type": "boolean", "description": "If true, include the full job description text. If false, descriptions are truncated to 500 characters.", "default": false }, "monitorMode": { "title": "Monitor mode (only new results)", "type": "boolean", "description": "Run on a schedule and deliver ONLY results not seen in a previous run. You are charged per new result, not for the whole feed each time. Ideal for daily monitoring. Requires the same input across runs.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. Shine.com's job-search JSON endpoint is publicly accessible with no anti-bot challenge, so a proxy is optional — leave the default (Apify auto/datacenter) unless you are running very high volume." } } }, "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 } } } } } } } } } }