{ "openapi": "3.0.1", "info": { "title": "Kariyer", "description": "Scrapes internship listings from Kariyer.net, Türkiye’s leading job platform. Extracts job titles, companies, locations, application links, and detailed descriptions for internships in Istanbul. Fully configurable with support for rate limiting and up to 1000 results.", "version": "0.0", "x-build-id": "QP6yKdIRfHOycOFXW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jesting_bureau~kariyer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jesting_bureau-kariyer", "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/jesting_bureau~kariyer/runs": { "post": { "operationId": "runs-sync-jesting_bureau-kariyer", "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/jesting_bureau~kariyer/run-sync": { "post": { "operationId": "run-sync-jesting_bureau-kariyer", "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": { "startUrl": { "title": "Custom Start URL", "type": "string", "description": "Custom URL to scrape from Kariyer.net. If provided, this will override all other URL parameters below.", "default": "" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of internship listings to scrape", "default": 100 }, "cityCodes": { "title": "City Codes", "type": "string", "description": "Comma-separated city codes for filtering locations (e.g., '34,82' for Istanbul Avrupa and Asya, '6' for Ankara, '35' for İzmir). Ignored if Custom Start URL is provided.", "default": "34,82" }, "jobType": { "title": "Job Type", "type": "string", "description": "Type of job to search for in the URL (e.g., 'stajyer' for internships, 'yazilim' for software jobs). Ignored if Custom Start URL is provided.", "default": "stajyer" }, "postingTime": { "title": "Posting Time Filter", "enum": [ "1s", "3s", "8s", "1d", "3d", "7d", "14d", "30d" ], "type": "string", "description": "Time filter for job postings. Ignored if Custom Start URL is provided.", "default": "8s" }, "lpstValue": { "title": "LPST Value", "type": "string", "description": "LPST parameter value for the URL (usually matches the number in posting time). Ignored if Custom Start URL is provided.", "default": "8" }, "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search for internship positions (optional). Ignored if Custom Start URL is provided.", "default": "" }, "location": { "title": "Location", "type": "string", "description": "City or location to search for internships (e.g., Istanbul, Ankara, İzmir). Ignored if Custom Start URL is provided.", "default": "" }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Whether to fetch detailed job descriptions from individual pages", "default": true }, "delayBetweenRequests": { "title": "Delay between requests (seconds)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Delay in seconds between HTTP requests to be respectful to the server", "default": 2 }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable Apify proxy rotation to avoid IP blocking and 403 errors", "default": true }, "proxyGroups": { "title": "Proxy Groups", "type": "array", "description": "Apify proxy groups to use (RESIDENTIAL, DATACENTER, etc.)", "default": [ "RESIDENTIAL" ], "items": { "type": "string" } }, "proxyCountryCode": { "title": "Proxy Country Code", "type": "string", "description": "Country code for proxy geolocation (TR for Turkey recommended)", "default": "TR" }, "customProxyUrls": { "title": "Custom Proxy URLs", "type": "array", "description": "Custom proxy URLs if not using Apify Proxy", "default": [], "items": { "type": "string" } }, "outputFormat": { "title": "Output format", "enum": [ "json", "csv", "xlsx" ], "type": "string", "description": "Format for the output data", "default": "json" }, "maxRetries": { "title": "Maximum retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of retries for failed requests", "default": 3 }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable detailed logging for debugging purposes", "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 } } }, "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 } } } } } } } } } }