{"openapi":"3.1.0","info":{"title":"ScrapeMole Arxiv: arXiv paper search and metadata for AI agents","version":"1.0.0","description":"Pay-per-call arXiv scholarly metadata: full-text search, paper cards by id, lightweight abstracts, and recent papers by subject category. Public arXiv Atom API only; affiliation emails are stripped. USDC via x402, no accounts.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://arxiv.scrapemole.workers.dev/terms","contact":{"email":"edgaras@mail.grokbot.com","url":"https://scrapemole.pages.dev"},"x-guidance":"Call any /v1 endpoint without payment to receive a 402 with the exact price, then retry with an x402 client (e.g. @x402/fetch). 4xx/5xx responses are never charged."},"servers":[{"url":"https://arxiv.scrapemole.workers.dev"}],"components":{"securitySchemes":{"x402":{"type":"http","scheme":"x402","description":"HTTP 402 payment with USDC via the x402 protocol."}}},"paths":{"/v1/arxiv/search":{"get":{"operationId":"arxivSearch","summary":"Full-text search of arXiv: matching papers with title, authors, abstract, categories, dates and PDF/abs links (affiliation emails stripped).","description":"Use when you need to discover arXiv e-prints by keyword, title, author or field query: pass any arXiv search_query string (e.g. \"transformer attention\", \"au:vaswani\", \"ti:\\\"attention is all you need\\\"\", \"cat:cs.LG AND all:diffusion\"). Returns up to 25 papers with id, title, summary, authors (names + affiliation without emails), primary category, categories, published/updated, comment, journal ref, DOI, abs and PDF URLs, plus totalResults for paging. Sort by relevance, lastUpdatedDate or submittedDate.","tags":["arxiv","papers","research","search","scholarly","science","preprints"],"parameters":[{"name":"q","in":"query","required":true,"description":"Search text or arXiv query (all:/ti:/au:/abs:/cat:…).","schema":{"type":"string","examples":["attention transformer"]}},{"name":"start","in":"query","required":false,"description":"0-based offset into the result set.","schema":{"type":"string","default":"0"}},{"name":"max_results","in":"query","required":false,"description":"Max results (1-25).","schema":{"type":"string","default":"10"}},{"name":"sortBy","in":"query","required":false,"description":"relevance | lastUpdatedDate | submittedDate.","schema":{"type":"string","enum":["relevance","lastUpdatedDate","submittedDate"],"default":"relevance","examples":["relevance"]}},{"name":"sortOrder","in":"query","required":false,"description":"ascending | descending.","schema":{"type":"string","enum":["ascending","descending"],"default":"descending"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"query":"attention transformer","total":1000,"count":1,"start":0,"results":[{"id":"1706.03762v7","title":"Attention Is All You Need","authors":[{"name":"Ashish Vaswani"}],"primaryCategory":"cs.CL","categories":["cs.CL","cs.LG"],"published":"2017-06-12T17:57:34Z","absUrl":"https://arxiv.org/abs/1706.03762v7","pdfUrl":"https://arxiv.org/pdf/1706.03762v7"}],"source":"arXiv API (https://export.arxiv.org/api/query)"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/arxiv/paper":{"get":{"operationId":"arxivPaper","summary":"One arXiv paper by id: title, abstract, authors, categories, dates, comment, journal ref, DOI, abs and PDF links (affiliation emails stripped).","description":"Use when you have an arXiv id (new-style like 1706.03762 or with version 1706.03762v7, or old-style like hep-ex/0307015) and need its public metadata card: title, abstract/summary, authors with affiliations (emails removed), primary category, all categories, published and updated timestamps, author comment, journal reference, DOI, and abs/PDF URLs. Without a version suffix, arXiv returns the latest version.","tags":["arxiv","papers","research","metadata","preprints","scholarly"],"parameters":[{"name":"id","in":"query","required":true,"description":"arXiv id, optionally with version (e.g. 1706.03762 or 1706.03762v7).","schema":{"type":"string","examples":["1706.03762"]}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"id":"1706.03762v7","title":"Attention Is All You Need","summary":"The dominant sequence transduction models…","authors":[{"name":"Ashish Vaswani"},{"name":"Noam Shazeer"}],"primaryCategory":"cs.CL","categories":["cs.CL","cs.LG"],"published":"2017-06-12T17:57:34Z","updated":"2023-08-02T00:41:18Z","comment":"15 pages, 5 figures","absUrl":"https://arxiv.org/abs/1706.03762v7","pdfUrl":"https://arxiv.org/pdf/1706.03762v7","source":"arXiv API (https://export.arxiv.org/api/query)"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/arxiv/abs":{"get":{"operationId":"arxivAbs","summary":"Lightweight arXiv abstract card by id: title, authors (names only), abstract, primary category, dates and abs/PDF links.","description":"Use when you need a compact abstract card for an arXiv id without full affiliation/journal/comment fields: returns id, title, summary, author names only, primary category, published/updated, absUrl and pdfUrl. Same id rules as /v1/arxiv/paper.","tags":["arxiv","papers","abstract","research","preprints"],"parameters":[{"name":"id","in":"query","required":true,"description":"arXiv id, optionally with version.","schema":{"type":"string","examples":["1706.03762"]}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"id":"1706.03762v7","title":"Attention Is All You Need","summary":"The dominant sequence transduction models…","authors":["Ashish Vaswani","Noam Shazeer"],"primaryCategory":"cs.CL","published":"2017-06-12T17:57:34Z","absUrl":"https://arxiv.org/abs/1706.03762v7","pdfUrl":"https://arxiv.org/pdf/1706.03762v7","source":"arXiv API (https://export.arxiv.org/api/query)"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}},"/v1/arxiv/category":{"get":{"operationId":"arxivCategory","summary":"Recent (or relevance-sorted) arXiv papers in a subject category such as cs.AI, cs.LG, hep-ex or math.CO.","description":"Use when you want the latest or relevance-ranked papers in one arXiv subject class: pass cat (e.g. cs.AI, quant-ph, stat.ML). Returns up to 25 papers with the same fields as search, plus totalResults for paging. Default sort is submittedDate descending (newest first).","tags":["arxiv","papers","category","research","preprints","cs.AI"],"parameters":[{"name":"cat","in":"query","required":true,"description":"arXiv category (e.g. cs.AI, hep-ex, math.CO).","schema":{"type":"string","examples":["cs.AI"]}},{"name":"start","in":"query","required":false,"description":"0-based offset.","schema":{"type":"string","default":"0"}},{"name":"max_results","in":"query","required":false,"description":"Max results (1-25).","schema":{"type":"string","default":"10"}},{"name":"sortBy","in":"query","required":false,"description":"relevance | lastUpdatedDate | submittedDate.","schema":{"type":"string","enum":["relevance","lastUpdatedDate","submittedDate"],"default":"submittedDate"}},{"name":"sortOrder","in":"query","required":false,"description":"ascending | descending.","schema":{"type":"string","enum":["ascending","descending"],"default":"descending"}}],"security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003","currency":"USD","network":"eip155:8453","networks":["eip155:8453"],"asset":"USDC"},"responses":{"200":{"description":"Result (the payment settles only for this status).","content":{"application/json":{"example":{"category":"cs.AI","total":50000,"count":1,"start":0,"results":[{"id":"2401.00001v1","title":"Example paper","primaryCategory":"cs.AI","absUrl":"https://arxiv.org/abs/2401.00001v1"}],"source":"arXiv API (https://export.arxiv.org/api/query)"}}}},"400":{"description":"Invalid input. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"402":{"description":"Payment required (x402). The PAYMENT-REQUIRED header (mirrored in the body) carries price, network and payTo."},"404":{"description":"Not found / no data. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"502":{"description":"Upstream error. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}},"504":{"description":"Upstream timeout. Not charged.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"charged":{"type":"boolean","const":false}}}}}}}}}}}}}