{ "openapi": "3.0.1", "info": { "title": "LinkedIn University Alumni Search by Degree & Year", "description": "Search a university's LinkedIn alumni by field of study, degree, graduation year, current employer, and location, and get each match's profile, current role, and detected education details. Needs your own LinkedIn session cookie.", "version": "1.0", "x-build-id": "6kZYH9Jt8iG3W1WUJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~linkedin-university-alumni-search-by-degree/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-linkedin-university-alumni-search-by-degree", "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/dataspryva~linkedin-university-alumni-search-by-degree/runs": { "post": { "operationId": "runs-sync-dataspryva-linkedin-university-alumni-search-by-degree", "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/dataspryva~linkedin-university-alumni-search-by-degree/run-sync": { "post": { "operationId": "run-sync-dataspryva-linkedin-university-alumni-search-by-degree", "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": { "mode": { "title": "Mode", "enum": [ "schoolInsights", "alumniProfiles" ], "type": "string", "description": "What to return: public school-level alumni insights, or individual public alumni profiles found by search.", "default": "schoolInsights" }, "schoolUrls": { "title": "School URLs or slugs", "type": "array", "description": "LinkedIn school page URLs or bare slugs, e.g. https://www.linkedin.com/school/mit/ or mit.", "items": { "type": "string" } }, "schoolNames": { "title": "School names", "type": "array", "description": "Plain university names when you do not have the LinkedIn URL, e.g. MIT or Harvard University. Names are resolved automatically.", "items": { "type": "string" } }, "maxSchools": { "title": "Max schools", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of schools to process in one run.", "default": 10 }, "maxAlumniPerSchool": { "title": "Max alumni per school", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum verified public profiles to return per school (mode=alumniProfiles). Values above 200 are clamped to 200 to keep runs bounded.", "default": 50 }, "degree": { "title": "Degree", "enum": [ "", "Bachelor", "Master", "MBA", "PhD", "Associate" ], "type": "string", "description": "Narrow discovery toward profiles whose public text mentions this degree (mode=alumniProfiles). Degree is best-effort because LinkedIn hides it on most guest profiles.", "default": "" }, "fieldOfStudy": { "title": "Field of study", "type": "string", "description": "School insights: a public field facet name or ID (e.g. Computer Science). Alumni profiles: searches and prefers this field (best-effort)." }, "currentFunction": { "title": "Current function", "type": "string", "description": "School insights only: a public function facet name or ID (e.g. Engineering)." }, "currentCompany": { "title": "Current company", "type": "string", "description": "School insights: a public company facet name or ID (e.g. Google). Alumni profiles: only return people whose public current employer matches." }, "currentLocation": { "title": "Current location", "type": "string", "description": "Alumni profiles only: only return people whose public location contains this text." }, "graduationYearRange": { "title": "Graduation year range", "type": "object", "description": "Alumni profiles only: keep profiles whose public education end year is inside this inclusive range.", "properties": { "start": { "title": "Start year", "type": "integer", "minimum": 1900, "maximum": 2100, "description": "Earliest graduation year to include (inclusive)." }, "end": { "title": "End year", "type": "integer", "minimum": 1900, "maximum": 2100, "description": "Latest graduation year to include (inclusive)." } } }, "includeSchoolProfile": { "title": "Include school profile details", "type": "boolean", "description": "School insights only: also fetch the school overview page for website, founding year, size, specialties and employee count. Adds one request per school.", "default": true } } }, "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 } } } } } } } } } }