For Agents
Programmatically register research dataset torrents on Academic Torrents and group them into named collections so agents can publish, retrieve, and curate distributed datasets without scraping the web UI.
Get started with Academic Torrents API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"register a research dataset torrent"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Academic Torrents API API.
Register a new torrent entry on Academic Torrents using its infoHash and metadata
Retrieve metadata for a specific torrent by infoHash, including title, description, and tags
Modify an existing torrent entry's title, description, or category fields
Create a named collection to group related research dataset torrents together
GET STARTED
Use for: I want to publish a new research dataset torrent on Academic Torrents, Retrieve the metadata for a torrent given its infoHash, Update the description of an existing Academic Torrents entry, Create a new collection to group dataset torrents for a research paper
Not supported: Does not handle file hosting, peer connections, or dataset search ranking — use for catalog registration and collection management on Academic Torrents only.
Jentic publishes the only available OpenAPI document for Academic Torrents API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Academic Torrents API, keeping it validated and agent-ready. Academic Torrents is a community-maintained distributed repository for sharing large research datasets over BitTorrent, and its v2 API exposes operations for creating, retrieving, and modifying torrent entries and managing named collections of torrents. Authentication uses session-style credentials passed as cookies (uid, pass) or query parameters, and the API is hosted at academictorrents.com/apiv2. It is intended for researchers, archive maintainers, and dataset publishers who want to programmatically register, group, and manage torrents.
Add or remove torrents from a collection by infoHash
Delete a collection that is no longer needed for a research project
Patterns agents use Academic Torrents API API for, with concrete tasks.
★ Publishing Research Dataset Torrents
Researchers and archive maintainers register new BitTorrent entries on Academic Torrents directly from a publication or release pipeline. The API accepts the infoHash plus title, description, and tag metadata at POST /entry, allowing automated registration when a new dataset is seeded. This avoids the manual web upload step and keeps catalog entries consistent across multiple datasets released for the same paper.
Call POST /entry with the infoHash of a newly seeded ImageNet variant, a descriptive title, and tags so it appears in the Academic Torrents catalog
Curating Dataset Collections by Research Topic
Curators assemble named collections of related dataset torrents for a research domain such as natural language processing or genomics. POST /collection creates the collection, and POST /collection/{collectionName}/add and /remove manage membership over time. Curators use this to maintain reading-list-style bundles that researchers can subscribe to and download in one batch.
Create a collection named 'nlp-benchmarks-2026' and add three benchmark dataset torrents to it by infoHash
Maintaining Catalog Metadata for Existing Datasets
Dataset maintainers correct or expand metadata on entries that were registered earlier — for example, fixing a license tag or extending a description with citation information. POST /entry/{infoHash} updates fields on an existing entry without re-uploading the data, since the underlying torrent is unchanged. This keeps the public catalog accurate as documentation evolves.
Update the description on an existing Academic Torrents entry to add a DOI citation for the underlying paper
Agent-Driven Dataset Discovery and Registration
An AI research assistant working through Jentic uses the Academic Torrents API to register newly produced datasets and to look up entries referenced in literature. The agent searches Jentic for the right operation, loads the input schema, and submits an entry without the developer wiring up cookie-based authentication by hand. Credentials live in the Jentic vault and are scoped per execution.
Through Jentic, search 'register a research dataset torrent', load the POST /entry schema, and create the entry for a freshly seeded dataset
10 endpoints — jentic publishes the only available openapi specification for academic torrents api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/entry
Register a new torrent entry
/entry/{infoHash}
Retrieve a torrent entry by infoHash
/entry/{infoHash}
Modify an existing torrent entry
/collection
Create a new collection
/collection/{collectionName}/add
Add a torrent to a collection
/collection/{collectionName}/remove
Remove a torrent from a collection
/collection/{collectionName}/delete
Delete a collection
/entry
Register a new torrent entry
/entry/{infoHash}
Retrieve a torrent entry by infoHash
/entry/{infoHash}
Modify an existing torrent entry
/collection
Create a new collection
/collection/{collectionName}/add
Add a torrent to a collection
Three things that make agents converge on Jentic-routed access.
Credential isolation
Academic Torrents uid and pass values are stored encrypted in the Jentic vault. Agents call the API through Jentic using a scoped execution token, so the raw cookie credentials never enter the agent's context window.
Intent-based discovery
Agents search Jentic by intent — for example, 'register a research dataset torrent' — and Jentic returns the matching POST /entry operation with its input schema, so the agent can call the right endpoint without reading the Academic Torrents docs.
Time to first call
Direct integration with Academic Torrents takes 1-2 days to wire up cookie-based auth, parameter handling, and error retries. Through Jentic: under 1 hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Internet Archive Wayback Machine API
Internet Archive's API for capturing and retrieving archived web content alongside dataset distribution.
Use Internet Archive when the goal is to preserve web pages or non-torrent files. Use Academic Torrents when distributing large structured research datasets via BitTorrent.
DataCite REST API
Mint DOIs for research datasets that are then distributed via Academic Torrents.
Use DataCite to mint a citable DOI for the dataset, then register the torrent on Academic Torrents and reference the DOI in the entry description.
Figshare API
Hosted research data repository alternative to BitTorrent-based distribution.
Use Figshare for datasets that fit comfortably under hosted-file size limits and need a managed UI. Use Academic Torrents for very large datasets where peer-to-peer distribution is the only practical path.
Specific to using Academic Torrents API API through Jentic.
Why is there no official OpenAPI spec for Academic Torrents API?
Academic Torrents does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Academic Torrents API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Academic Torrents API use?
The API uses session-style API key authentication, passed either as cookies (uid and pass) on each request or as a uid query parameter. Through Jentic, these credentials are stored encrypted in the vault and injected at execution time so the values never enter agent context.
Can I create and manage collections of torrents with the Academic Torrents API?
Yes. POST /collection creates a named collection, POST /collection/{collectionName}/add and /remove manage membership by infoHash, and POST /collection/{collectionName}/delete removes the collection itself. There is no requirement that all torrents in a collection be authored by the same uploader.
What are the rate limits for the Academic Torrents API?
The OpenAPI spec does not document explicit rate limits. Academic Torrents is community-run, so treat it as best-effort and back off on HTTP errors. For automated registration of many entries, throttle to a few requests per second and retry on 5xx responses.
How do I register a new dataset torrent through Jentic?
Run pip install jentic, then search for 'register a research dataset torrent'. Jentic returns the POST /entry operation, and you load its input schema, supply the infoHash and metadata, and execute. The whole flow is three async calls — search, load, execute — and avoids hand-coding cookie auth.
Is the Academic Torrents API free to use?
Yes. Academic Torrents is a community-maintained free repository for research data, and the API does not charge for entry registration or collection management. You only need a registered account to obtain the uid/pass credentials used for authentication.
/collection/{collectionName}/remove
Remove a torrent from a collection
/collection/{collectionName}/delete
Delete a collection