{ "openapi": "3.0.1", "info": { "title": "Djinni.co Jobs Scraper — Remote Tech Jobs", "description": "Scrape public Djinni.co job listings by keyword, country, city, or saved search URL. Return structured titles, companies, locations, remote status, salary, experience, English level, descriptions, and job URLs for recruiting and labor-market research.", "version": "1.0", "x-build-id": "7WGeK7xPPnaVejbWh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~djinni-co-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-djinni-co-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/muhammadafzal~djinni-co-jobs-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-djinni-co-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/muhammadafzal~djinni-co-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-djinni-co-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": { "searchQueries": { "title": "Job search queries", "type": "array", "description": "Use this for one or more Djinni job keywords or titles, for example software engineer. Defaults to software engineer; this is not a detail URL.", "items": { "type": "string", "minLength": 1 }, "default": [ "software engineer" ] }, "anyWords": { "title": "Any of these words", "type": "string", "description": "Use this for optional Djinni advanced-search terms such as senior fintech. Defaults to empty; this is not a second query list.", "default": "" }, "excludeWords": { "title": "Exclude words", "type": "string", "description": "Use this to exclude optional terms such as junior or internship. Defaults to empty; Djinni applies it to the search.", "default": "" }, "countries": { "title": "Countries", "type": "array", "description": "Use this to filter by country names such as Ukraine or Poland. Defaults to worldwide; use startUrls for an exact saved Djinni filter URL.", "items": { "type": "string" }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Use this to filter by city names such as Kyiv or Lviv. Defaults to all cities; this is not a country code.", "items": { "type": "string" }, "default": [] }, "startUrls": { "title": "Djinni search URLs", "type": "array", "description": "Use this for full public https://djinni.co/jobs/ search URLs when you need exact Djinni filters. Defaults to generated searches; detail URLs are not intended here.", "items": { "type": "string", "pattern": "^https://(www\\.)?djinni\\.co/jobs/" }, "default": [] }, "filters": { "title": "Additional Djinni filters", "type": "object", "description": "Use this for current Djinni query parameters not exposed above, for example employment=remote or exp_level=3y. Defaults to empty.", "default": {}, "additionalProperties": true }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Use this to cap total unique jobs returned across all searches. Enter 1 to 200; defaults to 20.", "default": 20 }, "maxPages": { "title": "Pages per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Use this to bound pagination for each search. Enter 1 to 20; defaults to 3.", "default": 3 }, "includeDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Use this to enrich jobs with public detail-page fields. Defaults to true; set false for a faster card-level export.", "default": true }, "maxRequestRetries": { "title": "Request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Use this to retry temporary Djinni request failures. Enter 0 to 5; defaults to 2.", "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 } } } } } } } } } }