{ "openapi": "3.0.1", "info": { "title": "Google Scholar Author Alternative: Find Experts & KOLs by Topic", "description": "Use this to find the academic experts and key opinion leaders on a research topic (Google Scholar author search alternative). Input: a topic plus country, institution and year filters. Output: ranked experts with ORCID, affiliation, h-index and topic papers.", "version": "0.1", "x-build-id": "x2vgkw624rg6vBzV2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pandadad0214~researcher-expert-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pandadad0214-researcher-expert-finder", "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/pandadad0214~researcher-expert-finder/runs": { "post": { "operationId": "runs-sync-pandadad0214-researcher-expert-finder", "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/pandadad0214~researcher-expert-finder/run-sync": { "post": { "operationId": "run-sync-pandadad0214-researcher-expert-finder", "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", "required": [ "topic" ], "properties": { "topic": { "title": "Research topic", "type": "string", "description": "What the experts work on, e.g. perovskite solar cells, antimicrobial resistance, large language models in healthcare. Matched against paper titles and abstracts. Use quotes for exact phrases (\"machine learning\") and AND / OR / NOT for Boolean searches.", "default": "perovskite solar cells" }, "maxResults": { "title": "Maximum experts", "minimum": 1, "maximum": 200, "type": "integer", "description": "You pay per expert returned, so this also caps the cost. Up to 200 (the ranked pool is the 200 authors with the most matching papers). Whole number, 1 to 200 results; default 25.", "default": 25 }, "countries": { "title": "Countries", "type": "array", "description": "Optional 2-letter ISO country codes (US, GB, DE, IN, AU…). Keeps experts whose current institution is in one of these countries, and counts only papers with an author in them.", "items": { "type": "string" } }, "institution": { "title": "Institution", "type": "string", "description": "Optional. University, hospital, lab or company name (e.g. Stanford University), a ROR ID or an OpenAlex institution ID (I…). Sub-units count too: a university includes its schools and hospitals. The matched institution is shown in the search log." }, "yearFrom": { "title": "Papers from year", "minimum": 1900, "type": "integer", "description": "Optional. Only count matching papers published in or after this year, e.g. 2020 for people active in the field recently. Whole number, 1900 or more." }, "yearTo": { "title": "Papers to year", "minimum": 1900, "type": "integer", "description": "Optional. Only count matching papers published up to this year. Whole number, 1900 or more." }, "activeSince": { "title": "Active since (year)", "minimum": 1900, "type": "integer", "description": "Optional. Only keep people who published anything in or after this year (uses OpenAlex yearly counts for the last ~10 years). Whole number, 1900 or more." }, "minTopicWorks": { "title": "Minimum matching papers", "minimum": 1, "type": "integer", "description": "Each expert must have at least this many papers on your topic. Whole number, 1 or more papers; default 2.", "default": 2 }, "minWorks": { "title": "Minimum total works", "minimum": 0, "type": "integer", "description": "Optional. Total works on the person's OpenAlex profile. Whole number, 0 or more works." }, "minCitations": { "title": "Minimum total citations", "minimum": 0, "type": "integer", "description": "Optional. Whole number, 0 or more citations." }, "minHIndex": { "title": "Minimum h-index", "minimum": 0, "type": "integer", "description": "Optional. Whole number, 0 or more." }, "sortBy": { "title": "Sort", "enum": [ "expertScore", "topicWorks", "topicCitations", "citations", "hIndex" ], "type": "string", "description": "Expert score (default) blends matching papers, their citations and h-index. Or sort by a single number.", "default": "expertScore" }, "papersPerExpert": { "title": "Recent papers per expert", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many of each expert's newest matching papers to list (title, year, DOI, citations). 0 to skip. Whole number, 0 to 10 papers; default 3.", "default": 3 }, "includeOrcid": { "title": "Add ORCID details", "type": "boolean", "description": "For experts with an ORCID iD, add current employment and role, keywords, websites and a short biography from the public ORCID record. Default: on.", "default": true }, "maxAuthorsPerPaper": { "title": "Ignore papers with more authors than", "minimum": 1, "type": "integer", "description": "Large collaboration papers (hundreds of authors) would make everyone on them look like an expert. Papers with more authors than this are not counted. Whole number, 1 or more authors; default 50.", "default": 50 }, "openAlexApiKey": { "title": "Your OpenAlex API key (optional)", "type": "string", "description": "Optional. A free key from openalex.org gives your runs their own daily OpenAlex budget for very large or frequent searches. Stored encrypted; never logged." } } }, "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 } } } } } } } } } }