# DOI Lookup — Crossref Titles, Venues, Dates and Citation Counts (`hermeskd/crossref-doi-metadata`) Actor

Crossref DOI lookup: Publication titles, venues, dates and citation counts. $0.0013 per DOI resolved; start extra; usage included; failed results uncharged.

- **URL**: https://apify.com/hermeskd/crossref-doi-metadata.md
- **Developed by:** [Logan Parker](https://apify.com/hermeskd) (community)
- **Categories:** Developer tools, Automation, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.04 / 1,000 doi resolveds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Crossref DOI lookup returns publication titles, venues, dates and citation counts for reference checks, without authors, abstracts or full text. AI agents can call and pay through Apify MCP. List event rates are $0.0013 per DOI resolved; start is extra, usage is included and failed results are uncharged.

### Example result

Example record for the minimal input under How to use it, as this Actor returned it on 2026-10-28 in a run of its production image; the record is kept unchanged with the release.

```json
{
  "doi": "10.1038/nphys1170",
  "ok": true,
  "resolvedDoi": "10.1038/nphys1170",
  "titles": [
    "Measured measurement"
  ],
  "containerTitles": [
    "Nature Physics"
  ],
  "workType": "journal-article",
  "publicationDateParts": [
    2009,
    1
  ],
  "citationCount": 11,
  "source": "Crossref"
}
```

### How to use it

Start a run in Apify Console, by API or from an agent with an input like this one — it is the input Apify runs every day to test this Actor:

```json
{"dois": ["10.1038/nphys1170"]}
```

Start with the minimal JSON example above, then adjust the fields in the table below. Read the Example result and Output fields sections for the returned record, Errors for failure codes, and Events and prices for result events and the separate platform start.

| Field | Type | Meaning |
|---|---|---|
| `dois` | array | 1–100 DOI strings; one metadata record per DOI; no author search, abstract extraction or full text. Use the public pool without a key, obey current rate headers, cap to one request per second and back off on 429. |

### Events and prices

| Event | Title | Charged when | FREE / BRONZE | SILVER | GOLD / PLATINUM / DIAMOND |
|---|---|---|---|---|---|
| `doi-resolved` | Doi Resolved | One successful input processed and its readable result stored. | $0.0013 | $0.00117 | $0.00104 |

Platform usage is not passed through. Apify's automatic actor-start event remains $0.00005 per started GB (one GB or less counts once). The synthetic dataset-item event is absent. Charge limits stop further paying work; unprocessed inputs receive uncharged errors. Completed readable pending events are settled on abort.

Worked cost example: ten successful doi resolved events cost $0.013 at list, plus actor start. Failures are not included in that count.

### Call it from an agent

Through Apify's MCP server (https://mcp.apify.com) use `call-actor`:

```json
{
  "actor": "hermeskd/crossref-doi-metadata",
  "input": {
    "dois": [
      "10.1038/nphys1170"
    ]
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.01,
    "timeout": 600
  },
  "waitSecs": 30
}
```

Then call `get-dataset-items` with the returned defaultDatasetId. Dedicated tool URL: https://mcp.apify.com?tools=hermeskd/crossref-doi-metadata

### Output fields

| Field | Meaning |
|---|---|
| `doi` | The caller supplied input, carried unchanged. |
| `ok` | True for a returned result; a failure is never charged. |
| `resolvedDoi` | DOI from the Crossref response. |
| `titles` | Title strings exactly as deposited. |
| `containerTitles` | Venue title strings. |
| `workType` | Crossref work type. |
| `publicationDateParts` | Date parts as deposited; missing month/day are not invented. |
| `citationCount` | is-referenced-by-count; Crossref coverage, not a universal citation count. |
| `source` | Crossref attribution. |
| `error` | Failure, always uncharged. |

### Limits and run time

The revised result price clears the retained conservative cold/default model on the measured successful cases at BRONZE, SILVER and GOLD. Actual platform costs, cold startup, source smoke and the deploy pricing floor remain release gates; local measurements do not prove hosted costs.

Complete serialized results must fit an 8 MB delivery budget, including input identity and JSON escaping. Oversized results are refused without a result charge. Invalid Unicode in failure echoes is escaped. Failure input echoes longer than 8,192 characters are shortened; blank list entries refuse the whole input without silently dropping entries.

1–100 DOI strings; one metadata record per DOI; no author search, abstract extraction or full text. Use the public pool without a key, obey current rate headers, cap to one request per second and back off on 429.

The default run timeout is 600 seconds. Local production-image smoke on 2026-10-28: 5.41 seconds at 256 MB and one CPU (the smallest configured memory). Platform cold start, billing and pricing-floor verification remain deploy gates.

### Errors

| Code | Meaning |
|---|---|
| `http_error` | The source answered an unsuccessful HTTP status. |
| `download_failed` | The request or connection failed within its bounded deadline. |
| `source_schema_changed` | The Crossref envelope, allowlisted field types or returned DOI identity changed; no raw response is returned. |
| `source_rate_limited` | Crossref asked for backoff; no result event charged. |
| `robots_disallowed` | robots.txt forbids fetching the URL; no request was made to it. |
| `blocked_host` | The host is on the deny-list or resolves to a private or local address; no request was made. |
| `too_large` | The response exceeded the size cap. |
| `timeout` | The input did not finish within the run's time budget. |
| `invalid_input` | The run input passed the input schema but cannot be used; the message names the field. |
| `internal_error` | Unexpected failure; the message carries the error class. |
| `charge_limit_reached` | The run reached its maximum total charge; this input was not processed. |

No failure record is charged. A run fails only when all input outcomes are Actor-side failures; caller errors and a mixture of caller/Actor failures do not fail the run.

### Sources and terms

Only process content you have the right to process. URL fetches obey HermesBot robots-group selection, the shared deny-list, public-address checks on connections and redirects, honest identity, deadlines and rate limits. No caller credentials, cookies, CAPTCHA solving, residential proxies or evasion. Crossref public REST works endpoint, bibliographic metadata usable for any purpose per its REST documentation. Authors, ORCIDs, affiliations, abstracts, references and raw response excluded. No third-party full text fetched.

### Not affiliated

This Actor is not affiliated with the source providers named here. Process only content you have the right to process.

### Related Hermes Actors

- [AI Crawler Checker: Which AI Bots robots.txt Allows per URL](https://apify.com/hermeskd/ai-crawler-access-check) — check declared robots.txt permissions for six AI crawlers at URL paths.
- [Article Extractor — News & Blog Text, Date and Markdown by URL](https://apify.com/hermeskd/article-extractor) — an article's clean text, title and publish date, without the rest of the page.
- [100K+ indexed jobs — Career Site Jobs API | 2026-11-03](https://apify.com/hermeskd/ats-job-search) — search open jobs in the Hermes directory of Greenhouse and Lever boards, each confirmed live.
- [Speech to Text — Transcribe Audio & Video URLs, Speaker Labels](https://apify.com/hermeskd/audio-to-transcript) — speech to text with SRT and VTT subtitles.
- [Video Converter — MP4 to MP3, Trim, GIF and Audio Extraction](https://apify.com/hermeskd/audio-video-convert) — audio and video conversion: MP4 to MP3, trim, GIF.
- [Broken Links Checker — Links, Assets, Redirects and Their Pages](https://apify.com/hermeskd/broken-links) — broken links, 404s and redirects on a site.
- [100K+ indexed jobs — Company ATS Finder API | 2026-11-03](https://apify.com/hermeskd/company-ats-board) — which hiring system and job board a company uses.
- [SEC EDGAR Filings — Recent Company Forms, Dates and XBRL Flags](https://apify.com/hermeskd/company-filing-index) — Read recent company financial filing metadata from the official SEC JSON API
- [CVE Vulnerability Lookup — NVD CVSS Scores and Exploited Flags](https://apify.com/hermeskd/cve-risk-metrics) — look up NVD CVE dates, status, numeric CVSS scores and severity.
- [Merge JSON Datasets — Deduplicate Rows, Export JSON and CSV](https://apify.com/hermeskd/dataset-json-cleaner) — json dataset cleaner.
- [DNS Lookup — Records, SPF Lookup Counts, DKIM & DMARC by Domain](https://apify.com/hermeskd/dns-and-email-auth) — DNS records and SPF, DKIM and DMARC checks.
- [DOCX to Markdown — Word, Excel, PowerPoint and EPUB Converter](https://apify.com/hermeskd/document-to-markdown) — Word, Excel, PowerPoint and other office files to Markdown.
- [Domain Availability Checker — Bulk RDAP Status and Registrar](https://apify.com/hermeskd/domain-availability) — whether domain names are available, from registry RDAP.
- [USGS Earthquake Lookup — Event Magnitude, Depth, Coordinates](https://apify.com/hermeskd/earthquake-event-metrics) — Read numeric USGS earthquake metadata for known event identifiers.
- [Currency Exchange Rates — ECB Daily Euro Rates and Cross Pairs](https://apify.com/hermeskd/ecb-exchange-rates) — Read latest ECB daily currency reference rates and calculated cross pairs.
- [Bulk File Downloader — Save URL Lists to Storage With SHA-256](https://apify.com/hermeskd/file-downloader) — files and images from URLs, saved with a public link each.
- [GitHub Repo Stats — Stars, Forks, Subscribers and Open Issues](https://apify.com/hermeskd/github-repository-metrics) — Read numeric metrics for known public GitHub repositories.
- [47K+ Greenhouse jobs — Live API | 2026-11-03](https://apify.com/hermeskd/greenhouse-jobs) — every open job on a company's Greenhouse board.
- [Hacker News Story Metrics — Scores, Comment Counts, Timestamps](https://apify.com/hermeskd/hacker-news-story-metrics) — read numeric Hacker News story scores, timestamps and comment counts by ID.
- [HTTP GET Request — Bulk Response Bodies, Status and SHA-256](https://apify.com/hermeskd/http-get-response) — public http get.
- [Security Headers Checker — HSTS, CSP, Framing, Nosniff by URL](https://apify.com/hermeskd/http-security-headers) — Check seven declared HTTP security header families without returning raw values.
- [Image Background Remover — U2NetP Cutouts for JPEG, PNG, WebP](https://apify.com/hermeskd/image-background-remover) — Remove image backgrounds with the small U2NetP model and return transparent PNG pixels as base64
- [Image Converter — JPEG, PNG and WebP With Resize and Quality](https://apify.com/hermeskd/image-format-converter) — image format converter.
- [Image Metadata Remover — EXIF and GPS Scrub, Pixels Verified](https://apify.com/hermeskd/image-metadata-remover) — GPS location, camera serial numbers and other private metadata removed from photos, losslessly.
- [Image to Text OCR — Text With Word Positions and Confidence](https://apify.com/hermeskd/image-to-text) — OCR: the text in images.
- [Image Upscaler — Real-ESRGAN 2x/4x for Photos and Graphics](https://apify.com/hermeskd/image-upscale) — image upscaling 2x or 4x, and photo restoration.
- [25K+ Lever jobs — Live API | 2026-11-03](https://apify.com/hermeskd/lever-jobs) — every published job on a company's Lever site, global or EU.
- [Lighthouse Audit — Lab Web Vitals and Scores, Mobile & Desktop](https://apify.com/hermeskd/lighthouse-audit) — Lighthouse scores and Core Web Vitals.
- [npm Package Lookup — Latest Version, License, Dependency Count](https://apify.com/hermeskd/npm-package-metadata) — read latest npm package versions, license tokens and dependency counts.
- [Website Change Monitor — Page Text Diffs Against Your Snapshots](https://apify.com/hermeskd/page-change-monitor) — what changed on a page since the last check.
- [PDF to Markdown — PDF Parser & Text Extractor With OCR](https://apify.com/hermeskd/pdf-to-markdown) — PDF to Markdown and text, with OCR for scanned pages.
- [Public Holidays Calendar — Holiday Dates for Five Countries](https://apify.com/hermeskd/public-holiday-calendar) — build offline public-holiday calendars for five countries and bounded years.
- [99 Remote OK jobs — Remote OK Feed API | 2026-11-02](https://apify.com/hermeskd/remote-jobs) — current remote jobs from Remote OK, with salary and listing links.
- [Research Paper Search — OpenAlex Papers, DOIs, Citation Counts](https://apify.com/hermeskd/research-paper-search) — Search OpenAlex for work-level paper metadata without authors, affiliations, abstracts or full text
- [RSS Feed Reader — Atom and JSON Feed Parser With Enclosures](https://apify.com/hermeskd/rss-feed-reader) — every item of an RSS, Atom or JSON feed.
- [SEO Audit — On-Page Score, Meta Tags, Schema & Fix Guidance](https://apify.com/hermeskd/seo-page-audit) — an on-page SEO audit: meta tags, schema, headings and links.
- [Sitemap Extractor — Unique URLs From XML, Gzip & Index Sitemaps](https://apify.com/hermeskd/sitemap-urls) — the URLs in a site's sitemaps.
- [Text to Speech — Offline English, German, Spanish WAV Voices](https://apify.com/hermeskd/text-to-speech) — Convert short nonpersonal texts to offline formant WAV speech for agents
- [Time Zone Converter API](https://apify.com/hermeskd/timezone-converter) — Convert one offset-qualified instant to named IANA time zones using pinned data.
- [URL to Markdown — Clean Text for LLM & RAG, With Selectors](https://apify.com/hermeskd/url-to-markdown) — a public job page as clean Markdown where the site allows it (deny-listed job sites are refused).
- [Extract Video Frames — Timed Stills by Interval or Scene Cut](https://apify.com/hermeskd/video-frames) — frames, thumbnails and scenes from a video.
- [Website Color Palette — CSS Colors With Alpha and Usage Counts](https://apify.com/hermeskd/website-color-palette) — Extract declared website CSS color literals and counts from public HTML and bounded linked stylesheets
- [Favicon Extractor — Icons, Touch Icons, Manifests, Theme Color](https://apify.com/hermeskd/website-icon-manifest) — declared website icons, theme colors and manifest links.
- [Website Screenshot — Full Pages, Elements, Dark Mode & PDF](https://apify.com/hermeskd/website-screenshot) — screenshots and PDF prints of web pages.
- [Tech Stack Detector — Website Technologies With Match Evidence](https://apify.com/hermeskd/website-tech-stack) — the technologies a website runs, detected live.
- [Website Crawler to Markdown — Same-Site Pages for LLM and RAG](https://apify.com/hermeskd/website-to-markdown) — bounded whole-site Markdown with robots and crawl-delay enforced

### Changelog

- 1.0 (2026-10-28) — Initial implementation, main-path fixtures and local production-image examples verified; publication awaits the scheduled merge.

# Actor input Schema

## `dois` (type: `array`):

1–100 DOI strings; one metadata record per DOI; no author search, abstract extraction or full text. Use the public pool without a key, obey current rate headers, cap to one request per second and back off on 429.

## Actor input object example

```json
{
  "dois": [
    "10.1038/nphys1170"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "dois": [
        "10.1038/nphys1170"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hermeskd/crossref-doi-metadata").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 = { "dois": ["10.1038/nphys1170"] }

# Run the Actor and wait for it to finish
run = client.actor("hermeskd/crossref-doi-metadata").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "dois": [
    "10.1038/nphys1170"
  ]
}' |
apify call hermeskd/crossref-doi-metadata --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hermeskd/crossref-doi-metadata"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/iVNUal5E18CuiRZvg/builds/lssPjOcltmLpw4cmK/openapi.json
