arxiv-taxonomy

When to invoke

• Building an arXiv query (wildcards, cross-listings, OR combinations)
• Interpreting a paper's primary_category vs secondary
• Recommending adjacent categories to a user interested in X
• Explaining to a user why a paper on gravitational waves shows up in both astro-ph.HE and gr-qc

Top-level archives

Critical sub-categories (astro-ph)

astro-ph has 6 subs — always query with wildcard cat:astro-ph* to catch all:

High-value cross-listings (papers often submitted to both)

Knowing these pairs dramatically improves filter recall:

Query patterns (arxiv API)

# Whole archive (including all subs):
cat:astro-ph*       # use wildcard

# Specific sub:
cat:astro-ph.CO

# Union of two archives:
cat:gr-qc OR cat:hep-th

# Archive + date range (use submittedDate field):
cat:quant-ph AND submittedDate:[202601010000 TO 202604010000]

# Keywords in title/abstract only:
ti:"neutron star" AND abs:"binary"

# Combined:
(cat:astro-ph.HE OR cat:gr-qc) AND abs:"gravitational wave"

Categorical sortBy values

• relevance — default, poor for recent-papers workflows
• lastUpdatedDate — includes revisions (can be misleading)
• submittedDate — use this for "recent" queries

Plus sortOrder=descending or ascending.

Rate etiquette

• arXiv expects you to cache. Re-poll no more than every 3 s.
• If scraping listings in bulk (>1000 results), insert delay between calls ≥3 s.
• Use a User-Agent identifying your tool. Example:

User-Agent: my-research-tool/1.0 (contact: [email protected])

• 503s on hot endpoints — back off exponentially from 30 s.

Paper ID anatomy

Format (post-2007): YYMM.NNNNN + optional version.

• 2604.13012v1 — April 2026, submission 13012, v1
• Year+month encodes submission date, not publication. Two papers with same YYMM.xxxxx were submitted on adjacent days.

Legacy format (pre-2007): archive.subfield/YYMMnnn e.g. hep-th/9901139.

Cross-field tags most relevant to a physics-paper reader

When user says "quantum optics", they want the union of:

• quant-ph (primary)
• physics.optics
• physics.atom-ph (cold atoms, ion traps)
• sometimes cond-mat.mes-hall (mesoscopic)

When user says "cosmology", union:

• astro-ph.CO (primary)
• gr-qc
• hep-ph (dark matter, baryogenesis)
• hep-th (inflation models, holography interfaces)

When user says "dark matter", union:

• hep-ph
• astro-ph.CO
• astro-ph.HE (indirect detection)
• sometimes physics.ins-det (direct detection experiments)

_Last reviewed: 2026-05-14 — polish per #23._