{ "openapi": "3.0.1", "info": { "title": "LinkedIn University Alumni Career Mapper", "description": "Map where a university's graduates ended up: employer, role, location and graduation year, aggregated into top employers and destinations. Requires your own li_at session cookie - LinkedIn blocks school pages outright for logged-out visitors.", "version": "0.0", "x-build-id": "y0TA2rbXyXBsd4djc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~linkedin-alumni-career-mapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-linkedin-alumni-career-mapper", "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/fanndev~linkedin-alumni-career-mapper/runs": { "post": { "operationId": "runs-sync-fanndev-linkedin-alumni-career-mapper", "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/fanndev~linkedin-alumni-career-mapper/run-sync": { "post": { "operationId": "run-sync-fanndev-linkedin-alumni-career-mapper", "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": { "schoolUrls": { "title": "School pages", "type": "array", "description": "Universities to map. A linkedin.com/school/... URL or a bare school slug both work; a bare slug is treated as a school, not a company.", "items": { "type": "string" } }, "startUrls": { "title": "School pages (request list)", "type": "array", "description": "The same school links in the request-list format, for callers that already keep one.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sessionCookie": { "title": "Your li_at session cookie (required)", "type": "string", "description": "Mandatory, and LinkedIn is stricter about school pages than about anything else in this portfolio: /school/ answers HTTP 999 to logged-out visitors on every path, including the /company/ alias that redirects there, and unlike the ordinary rate gate it does not clear with delays. There is no public school record to fall back on. To get the cookie: sign in to LinkedIn in your browser, open DevTools > Application > Cookies > www.linkedin.com, copy the VALUE of li_at. This actor never asks for your password and never signs in on your behalf. Scraping while signed in breaches LinkedIn's User Agreement and accounts do get restricted - use one you are willing to risk. Without a cookie the run still finishes successfully and explains itself in the dataset." }, "filterKeywords": { "title": "Narrow the alumni search", "type": "string", "description": "Passed to LinkedIn's own search box alongside the school filter - 'software engineer', 'product manager', 'Jakarta'. Narrowing server-side is much cheaper than reading every alumnus and filtering afterwards, and for large universities it is the only way to get a useful slice." }, "maxAlumniPerSchool": { "title": "Maximum alumni per school", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap per school. LinkedIn's people search stops serving results past roughly 1,000 regardless, and large universities have far more alumni than that - so treat any result as a sample, not a census.", "default": 200 }, "maxAlumni": { "title": "Maximum alumni in total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Overall ceiling across every school.", "default": 1000 }, "emitSummary": { "title": "Emit a summary row per school", "type": "boolean", "description": "Append a SUMMARY row per school with top employers, top locations, top roles and the graduation-year range - the aggregate a tracer study actually wants out of the individual rows.", "default": true }, "minDelaySeconds": { "title": "Minimum delay between requests", "minimum": 0, "maximum": 60, "type": "integer", "description": "LinkedIn answers request bursts with HTTP 999. With a session cookie in play the randomised gap does double duty: it keeps the run under the rate gate and keeps it looking like a person rather than a script.", "default": 3 }, "maxDelaySeconds": { "title": "Maximum delay between requests", "minimum": 0, "maximum": 120, "type": "integer", "description": "The ceiling of the randomised gap. Raise both bounds if the log shows rate-gate warnings.", "default": 8 }, "exportFormats": { "title": "Extra export files", "type": "array", "description": "Besides the dataset, write ready-made files into this run's key-value store.", "items": { "type": "string", "enum": [ "json", "ndjson", "csv", "excel" ], "enumTitles": [ "JSON", "NDJSON", "CSV", "Excel (XLSX)" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy (strongly advised)", "type": "object", "description": "This actor always runs with your session cookie, so use RESIDENTIAL in your own country. LinkedIn scores the exit IP against where your account normally signs in, and an Apify datacenter IP is precisely the mismatch that gets a session flagged.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }