API Documentation

Getting Started

Authentication

API Key

All requests must include an authentication bearer token in the headers.


                            curl -X GET "https://api.papers.html/papers" \
                            -H "Authorization: Bearer YOUR_API_KEY_HERE" \
                            -H "Content-Type: application/json"

Scopes

Access levels:

• read:public - access public paper metadata
• write:private - manipulate private drafts
• analyze:full - access analytics tools

Rate Limits

Standard API tiers:

Free

5000

requests/month

Research

100,000

requests/month

Business

5,000,000+

custom tiers

Request Rate Headers

X-rate-limit-remaining: 4235

x-rate-limit-reset: 3584

Available Endpoints

GET /api/search

Search Papers

Query over 15 million academic papers with full-text search, filters by field, publication year, and citation count.

{
  "query": "quantum computing",
  "filter": {
    "start_year": 2020,
    "subject": "Physics"
  }
}

Returns JSON array with metadata and metrics for each paper including DOI, citation count, and access status.

Response Sample 200 OK

[
  {
    "id": "10.7910/papers.12345",
    "title": "Quantum Computing Breakthrough",
    "citations": 215,
    "access": "open"
  }
]

get /api/paper/{id}

Get Paper Details

Retrieve complete metadata, full text (when available), citations, and author information for any paper.

{
  "id": "10.7910/papers.23456",
  "title": "Neural Networks Breakthrough",
  "authors": ["Dr. Lena Smith", "Prof. Michael Lee"],
  "citations": 345,
  "access": "subscription",
  "abstract": "This paper presents a novel neural network architecture..."

Parameters

id: string - Paper identifier (DOI or handle)

post /api/paper/upload

Upload Research

Add new academic research with AI formatting, plagiarism checks, and metadata validation. Requires write:private scope.

{
  "title": "CRISPR Based Gene Editing",
  "abstract": "This paper demonstrates...",
  "file": "base64-encoded-pdf"
}

Requires API key with write:private scope. Use multipart/form-data for large files.

Returns paper DOI and upload status. Triggers AI analysis pipeline including citation mapping and academic impact score calculation.

Code Samples

JavaScript

fetch('https://api.papers.html/api/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY HERE',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    'query': 'quantum computing',
    'filter': { 'year': '2024' }
  })
})

Python

response = requests.post(
    'https://api.papers.html/api/paper/10.71234/papers.23456',
    headers={
        'Authorization': 'Bearer YOUR_api_KEY_HERE',
        'Accept': 'application/json'
    }
)
data = response.json()

CURL

curl -X GET 
    -H "Authorization: Bearer YOUR_api_key_here" 
    -H "Accept: application/json" 
    https://api.papers.html/api/paper/10.123456/papers.78901