# ORCID Public Profiles Scraper API - Researchers & Works (`pink_comic/orcid-public-researcher-profiles-works`) Actor

Search ORCID's public v3 API by exact ORCID iD or bounded name, affiliation, and keyword criteria. Normalize public researcher names, biography, identifiers, affiliations, works, visibility, and assertion sources with explicit evidence limits.

- **URL**: https://apify.com/pink\_comic/orcid-public-researcher-profiles-works.md
- **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community)
- **Categories:** Education, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 orcid public profiles scraper api - researchers &  evidence items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## ORCID Public Profiles Scraper API – Researchers & Works

Search ORCID's public v3 API by exact ORCID iD, researcher name, affiliation organization, or keyword. Each paid profile item nests bounded public works and activities while preserving visibility and source/assertion metadata.

### Fast start

```json
{"orcidIds":["0000-0002-1825-0097"],"maxResults":1,"maxWorks":25,"maxActivities":25}
```

Empty input uses the same public ORCID documentation/demo profile and returns one item. For expanded search, clear `orcidIds`:

```json
{"orcidIds":[],"name":"Josiah Carberry","affiliation":"Brown University","maxCandidates":20,"maxResults":5}
```

Outputs include canonical profile URL, public names/biography/keywords/URLs/external IDs, normalized employments, educations, memberships and related affiliations, public work summaries, section visibility, assertion sources, retrieval time, and bounded-query disclosure. Private or absent sections are stable empty arrays.

### Pricing and limits

**$0.0001/start + $0.002/profile item.** The one-profile default costs at most **$0.0021**. Results are capped at 20, expanded-search candidates at 50, and works/activities at 100 per profile. A configured maximum total run charge reduces the profile cap before source requests.

### Important interpretation limits

ORCID records are self-managed and contributor-supplied. ORCID does not verify identity, employment, current affiliation, education, membership, authorship, or external-identifier ownership. Visibility and assertion-source metadata are evidence about the returned record, not independent verification. Records may be private, incomplete, duplicated, stale, corrected, or removed. `NO_MATCH` is limited to the exact or bounded public query checked; `SOURCE_UNAVAILABLE` produces no profile conclusion.

Source: ORCID Public API v3 (`https://pub.orcid.org/v3.0`), requested as `application/vnd.orcid+json`. No OAuth or credentials required.

# Actor input Schema

## `orcidIds` (type: `array`):

One or more checksum-valid ORCID iDs. At most 20.

## `name` (type: `string`):

Bounded ORCID expanded search of public given/family names. Clear the default exact iD first.

## `affiliation` (type: `string`):

Bounded expanded search of public affiliation organization names.

## `keyword` (type: `string`):

Bounded expanded search of public ORCID keywords.

## `maxCandidates` (type: `integer`):

Maximum expanded-search candidates checked; results disclose when the source found more.

## `maxResults` (type: `integer`):

Total paid profile items. Empty/default input returns one item for a maximum first-run price of $0.0021 including the $0.0001 start.

## `maxWorks` (type: `integer`):

Maximum public work summaries nested inside each paid profile item.

## `maxActivities` (type: `integer`):

Maximum combined public employment, education, membership, qualification, service, invited-position, and distinction summaries.

## `maxIdentifiers` (type: `integer`):

Maximum public person-level external identifier assertions returned per profile.

## Actor input object example

```json
{
  "orcidIds": [
    "0000-0002-1825-0097"
  ],
  "maxCandidates": 20,
  "maxResults": 1,
  "maxWorks": 25,
  "maxActivities": 25,
  "maxIdentifiers": 50
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "orcidIds": [
        "0000-0002-1825-0097"
    ],
    "maxResults": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("pink_comic/orcid-public-researcher-profiles-works").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "orcidIds": ["0000-0002-1825-0097"],
    "maxResults": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("pink_comic/orcid-public-researcher-profiles-works").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "orcidIds": [
    "0000-0002-1825-0097"
  ],
  "maxResults": 1
}' |
apify call pink_comic/orcid-public-researcher-profiles-works --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=pink_comic/orcid-public-researcher-profiles-works",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/pcNYZ6UeJmGIFNsjA/builds/7TykGLxZkqiglAuVu/openapi.json