{ "openapi": "3.0.1", "info": { "title": "Universitat de Barcelona PhD Vacancy Scraper", "description": "Extract doctoral-programme vacancies and PhD calls from Universitat de Barcelona. An AI step (bring your own Anthropic key) parses the university's pages into clean records: title, programme, deadline, apply URL. Best for PhD-alert services covering Spain and Catalonia.", "version": "0.1", "x-build-id": "0LSSgUidhQhsVOUcp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nomad-agent~ub-doctoral-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nomad-agent-ub-doctoral-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/nomad-agent~ub-doctoral-scraper/runs": { "post": { "operationId": "runs-sync-nomad-agent-ub-doctoral-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/nomad-agent~ub-doctoral-scraper/run-sync": { "post": { "operationId": "run-sync-nomad-agent-ub-doctoral-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": { "provider": { "title": "AI provider", "enum": [ "anthropic", "mistral" ], "type": "string", "description": "Which AI provider runs discovery + extraction. \"anthropic\" (default) uses a Claude agent with Anthropic's built-in web-search and web-fetch tools. \"mistral\" fetches UB's landing/HR pages directly (plain HTTP, no bot protection on this source) and follows a few vacancy-looking links, then a Mistral model extracts structured fields from the combined page text -- pick this if you'd rather bring a Mistral key than an Anthropic one.", "default": "anthropic" }, "anthropicApiKey": { "title": "Anthropic API key", "type": "string", "description": "Your Anthropic API key (sk-ant-...). Required when provider is \"anthropic\" — this Actor uses Claude with web search to find and parse UB vacancy pages. Can also be set via the ANTHROPIC_API_KEY environment variable. Anthropic bills usage on this key to your own Anthropic account, separately from Apify's charges for this Actor." }, "mistralApiKey": { "title": "Mistral API key", "type": "string", "description": "Your Mistral API key. Required when provider is \"mistral\". Can also be set via the MISTRAL_API_KEY environment variable. Mistral bills usage on this key to your own Mistral account, separately from Apify's charges for this Actor." }, "mistralModel": { "title": "Mistral model", "enum": [ "mistral-small-latest", "mistral-medium-latest", "mistral-large-latest" ], "type": "string", "description": "Mistral model for extraction (provider=\"mistral\" only). Small is the default -- testing found it matches larger Mistral models on this task (extraction is small and well-scoped) at a fraction of the cost.", "default": "mistral-small-latest" }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 50, "type": "integer", "description": "Maximum number of PhD vacancies to return (0 = no limit, capped internally at 50 for cost safety). Each returned vacancy is billed as one Apify result, and every run also consumes Anthropic tokens billed separately to your own API key.", "default": 12 }, "postedSince": { "title": "Posted since", "type": "string", "description": "Only return vacancies posted on or after this date. Vacancies whose posted date can't be read are still included, not silently dropped. Leave empty to disable the filter." }, "model": { "title": "Anthropic model", "type": "string", "description": "Claude model to use for scraping. A fast, low-cost model is recommended.", "default": "claude-haiku-4-5-20251001" } } }, "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 } } } } } } } } } }