APIReference

Get paper metadata

Get paper metadata by arXiv ID or internal UUID.

Optionally include additional fields like TOC, summaries, figures, etc.

GET
/papers/{id}

Authorization

ApiKeyAuth
x-api-key<token>

API key for authentication. Get yours at https://sciencestack.ai/settings/api

Format: sk_live_... or sk_test_...

In: header

Path Parameters

id*string

Paper ID — either arXiv ID (e.g., 1706.03762) or internal UUID

Query Parameters

include?string

Comma-separated list of additional fields to include:

  • toc: Table of contents
  • summaries: AI-generated summaries (Pro only)
  • figures: Figure captions
  • tables: Table captions
  • mathEnvs: Math environments (theorems, lemmas, etc.)

Response Body

application/json

application/json

application/json

curl -X GET "https://sciencestack.ai/api/v1/papers/1706.03762?include=toc"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "title": "string",
    "arxivId": "string",
    "authors": [
      {
        "name": "string"
      }
    ],
    "summary": "string",
    "primaryCategory": "string",
    "published": "2019-08-24T14:15:22Z",
    "citationCount": 0
  },
  "_version": "string"
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}
{
  "error": {
    "code": "PAPER_NOT_FOUND",
    "message": "Paper not found: 9999.99999"
  }
}

List papers by category

Browse papers by category or semantic field. Use this to explore papers without a search query. **Does not count toward paper quota.** For full-text search, use `GET /search` instead.

Get paper overview

Get everything an agent needs in one call: metadata, TOC, AI summaries, and lists of all figures, tables, equations, and theorems. **Does not count toward paper quota** (free peek). - **Free**: metadata, TOC, figures/tables/equations lists - **Pro+**: + `aiSummary`, `sectionSummaries`