# arXiv Papers Scraper — Abstracts, Authors, Categories & PDFs (`hipersoft/arxiv-scraper`) Actor

Search and extract arXiv papers: title, abstract, authors, categories, published/updated dates, DOI, journal reference, and direct PDF links. Filter by category and sort by newest, recently updated or relevance. Fetch by arXiv ID too. For research, lit reviews and AI/ML monitoring. No setup.

- **URL**: https://apify.com/hipersoft/arxiv-scraper.md
- **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community)
- **Categories:** News
- **Features:** Limited permissions
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00125 / paper scraped

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

## arXiv Papers Scraper — Abstracts, Authors, Categories & PDF Links

Search and extract papers from **arXiv.org** as clean, structured **JSON, CSV, Excel or XML**: title, full abstract, authors, subject categories, submission/update dates, DOI, journal reference, and direct **PDF links**. Search by keyword, filter by category, sort by newest or relevance, or fetch exact papers by arXiv ID. Fast and reliable.

![arXiv Papers Scraper input — search terms, categories and sort order in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/arxiv-scraper-input.png?v=2)

### What does the arXiv Papers Scraper do?

The arXiv Papers Scraper searches the full arXiv corpus and extracts complete, structured metadata for every matching paper. Use plain keywords or structured field queries, narrow by subject category, and export thousands of papers with abstracts and PDF links in a single run — ideal for literature reviews, research monitoring, and building AI/ML datasets.

### Features

- 🔎 **Keyword & field search** — plain terms or structured queries (`ti:`, `au:`, `abs:`, `cat:`) across the full arXiv corpus
- 🗂️ **Category filters** — narrow to fields like `cs.CL`, `cs.AI`, `math.PR`, `stat.ML`, and combine them
- 🆔 **Fetch by ID** — pass a list of arXiv IDs to pull specific papers directly
- 📅 **Sort your way** — by relevance, newest submitted, or most recently updated
- 📄 **Full abstracts + PDF links** — the complete summary text plus direct `abs` and `pdf` URLs
- 👥 **Structured authors** — clean author list, count, and a display string

### What you get

![arXiv Papers Scraper output example — paper records with title, abstract, authors and PDF links as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/arxiv-scraper-output.png?v=5)

Each paper is one dataset record:

```json
{
  "query": "large language models",
  "arxivId": "2403.09676v1",
  "arxivIdBase": "2403.09676",
  "title": "Unmasking the Shadows of AI: Investigating Deceptive Capabilities in Large Language Models",
  "summary": "This research critically navigates the intricate landscape of AI deception...",
  "authors": ["Linge Guo"],
  "authorsList": "Linge Guo",
  "authorCount": 1,
  "primaryCategory": "cs.CL",
  "categories": ["cs.CL", "cs.AI"],
  "published": "2024-02-07T00:21:46Z",
  "updated": "2024-02-07T00:21:46Z",
  "doi": null,
  "journalRef": null,
  "comment": "AI deception, Large Language Models, ChatGPT",
  "absUrl": "https://arxiv.org/abs/2403.09676v1",
  "pdfUrl": "https://arxiv.org/pdf/2403.09676v1"
}
```

#### Output schema

| Field | Type | Description |
| --- | --- | --- |
| `query` | string | The search term this paper matched (echoed for traceability) |
| `arxivId` | string | Full arXiv identifier including version (e.g. `2403.09676v1`) |
| `arxivIdBase` | string | arXiv identifier without the version suffix |
| `title` | string | Paper title |
| `summary` | string | Full abstract text |
| `authors` | array | List of author names |
| `authorsList` | string | Authors joined as a single display string |
| `authorCount` | integer | Number of authors |
| `primaryCategory` | string | Primary arXiv subject category (e.g. `cs.CL`) |
| `categories` | array | All subject categories the paper is tagged with |
| `published` | string (ISO date) | Original submission date/time |
| `updated` | string (ISO date) | Most recent revision date/time |
| `doi` | string | DOI, if the paper has one (else null) |
| `journalRef` | string | Journal reference, if published (else null) |
| `comment` | string | Author-provided comment / note |
| `absUrl` | string (URL) | Link to the arXiv abstract page |
| `pdfUrl` | string (URL) | Direct link to the paper PDF |

### Input

```json
{
  "searchTerms": ["large language models", "cat:cs.CL"],
  "categories": ["cs.AI"],
  "sortBy": "newest",
  "maxResultsPerQuery": 200,
  "includeAbstract": true
}
```

| Field | Type | Description |
|-------|------|-------------|
| `searchTerms` | array | Keywords or structured `field:value` queries. Multi-word phrases are matched as phrases. |
| `categories` | array | arXiv subject categories to filter by (e.g. `cs.CL`, `stat.ML`). Combine with terms or use alone. |
| `idList` | array | Fetch specific papers by arXiv ID (skips search when provided). |
| `sortBy` | string | `relevance` (default), `newest`, or `lastUpdated`. |
| `maxResultsPerQuery` | integer | Max papers per query (1–2000). |
| `includeAbstract` | boolean | Include the full abstract text (default `true`). |

### Use cases

- **Literature reviews** — pull every recent paper on a topic with abstracts in one run.
- **Research monitoring** — track new submissions in your categories, sorted newest-first.
- **AI/ML datasets** — build corpora of titles + abstracts for classification, search, or RAG.
- **Citation & metadata** — grab DOIs, journal refs, and PDF links at scale.
- **Trend analysis** — measure output by category, author or time to spot emerging topics.

### How to scrape arXiv papers

1. Add the arXiv Papers Scraper to your Apify account.
2. Enter one or more **search terms** (keywords or `field:value` queries), or an **idList** for exact papers.
3. Optionally set **categories**, **sortBy** and **maxResultsPerQuery**.
4. Click **Run**.
5. **Export** the dataset as JSON, CSV, Excel or XML, or pull it via the Apify API.

### Need more research data?

- [Crossref Scraper](https://apify.com/hipersoft/crossref-scraper) — DOIs, citation counts and metadata from 150M+ registered works.
- [OpenLibrary Scraper](https://apify.com/hipersoft/openlibrary-scraper) — book metadata, authors, subjects and editions.
- [ClinicalTrials Scraper](https://apify.com/hipersoft/clinicaltrials-scraper) — study records from the clinical trials registry.

### FAQ

**How many papers can I scrape per run?**
Up to 2,000 papers per query via `maxResultsPerQuery`, and you can pass multiple search terms in one run, so a single run can return many thousands of papers.

**How does billing work?**
You pay only per paper you get, so small filtered runs stay cheap. See the **Pricing** tab for current rates.

**What format is the output?**
Clean structured JSON — one record per paper — exportable as JSON, CSV, Excel or XML. Each record includes the title, full abstract, authors, categories, dates, DOI and direct PDF links.

**Can I filter by category or fetch specific papers?**
Yes. Use `categories` to narrow to fields like `cs.CL`, `cs.AI` or `stat.ML`, combine them with keywords, or pass an `idList` of arXiv IDs to pull exact papers directly.

**Is this only public data?**
Yes. It returns only openly available arXiv metadata and doesn't touch anything behind a login.

**Can I connect this to other tools?**
The arXiv Papers Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

### Related Actors

- [Crossref Scraper](https://apify.com/hipersoft/crossref-scraper)
- [OpenLibrary Scraper](https://apify.com/hipersoft/openlibrary-scraper)
- [ClinicalTrials Scraper](https://apify.com/hipersoft/clinicaltrials-scraper)
- [Wikipedia Scraper](https://apify.com/hipersoft/wikipedia-scraper)

### Notes

Original clean-room implementation. Returns only public arXiv metadata; you are responsible for compliance with arXiv's terms. arXiv is a trademark of Cornell University; this Actor is independent and not affiliated with or endorsed by arXiv.

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords or phrases to search (title + abstract + full text). You may also pass a raw arXiv query using field prefixes, e.g. ti:"attention is all you need" or au:hinton.

## `categories` (type: `array`):

Optional arXiv category codes to restrict to, e.g. cs.CL, cs.LG, stat.ML, math.PR, hep-th. Combined with the search terms.

## `idList` (type: `array`):

Optional. Fetch these specific papers by arXiv ID (e.g. 2201.00978 or 1706.03762v5). When set, search terms are ignored.

## `sortBy` (type: `string`):

Ordering of search results.

## `maxResultsPerQuery` (type: `integer`):

Maximum papers to collect per search term (or in total for an ID list).

## `includeAbstract` (type: `boolean`):

Include the paper abstract in the output.

## `proxyConfiguration` (type: `object`):

Proxy configuration. Leave the default — it is tuned for reliable results.

## Actor input object example

```json
{
  "searchTerms": [
    "diffusion models",
    "au:bengio"
  ],
  "categories": [
    "cs.CL",
    "cs.LG"
  ],
  "idList": [
    "1706.03762",
    "2005.14165"
  ],
  "sortBy": "relevance",
  "maxResultsPerQuery": 50,
  "includeAbstract": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All dataset items produced by this run.

# 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 = {
    "searchTerms": [
        "large language models"
    ],
    "categories": [],
    "idList": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/arxiv-scraper").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 = {
    "searchTerms": ["large language models"],
    "categories": [],
    "idList": [],
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/arxiv-scraper").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 '{
  "searchTerms": [
    "large language models"
  ],
  "categories": [],
  "idList": []
}' |
apify call hipersoft/arxiv-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/arxiv-scraper"
        }
    }
}
```

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/Az87MHmQZC5e7qLmW/builds/tydiUHZOqmzfZAcyw/openapi.json