{"uid":"cap_SB4E9X-vu1vBO-EFv7d2B","slug":"academic-evidence-pack-scholarly-evidence-finder-a076bd6a","name":"Academic Evidence Pack – Scholarly Evidence Finder","description":"Find 3-10 scholarly candidates for a question or topic. Returns DOI/OpenAlex IDs, authors, year, venue, source URLs, citation context, open-access location, and known retraction/correction warnings. JSON only. Does not claim that a paper proves a statement.","url":"https://aep-api.fly.dev/v1/evidence-pack","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":5,"maximum":10,"minimum":3},"query":{"type":"string","maxLength":500,"minLength":8,"description":"Question, claim, or research topic."},"fields":{"type":"array","items":{"enum":["papers","relevance","impact_context","access","integrity","provenance"],"type":"string"},"description":"Optional response minimization."},"to_year":{"type":"integer"},"from_year":{"type":"integer"},"open_access_only":{"type":"boolean","default":false},"exclude_known_retracted":{"type":"boolean","default":false,"description":"Default keeps retracted records but marks them; true filters them."}}},"responseSchema":{"type":"json","example":{"stats":{"cache":"miss","latency_ms":2140,"duplicates_removed":1,"filtered_retracted":0,"candidates_retrieved":15},"papers":[{"type":"article","year":2024,"title":"…","venue":"…","access":{"is_oa":true,"source":"openalex","license":"cc-by","best_url":"https://…","confidence":"reported","retrieved_at":"…"},"authors":[{"name":"…","orcid":null}],"integrity":{"note":"No update records found on checked sources. This is not proof of validity.","status":"none_found","updates":[],"sources_checked":["openalex","crossref"]},"relevance":{"rank":1,"score":0.87,"reason":"provider relevance; DOI; complete metadata; recent"},"provenance":{"title":{"source":"openalex","retrieved_at":"…"}},"identifiers":{"doi":"10.xxxx/…","openalex":"W…"},"source_urls":["https://doi.org/10.xxxx/…","https://openalex.org/W…"],"impact_context":{"note":"Citation count is impact context from one provider, not a quality score.","source":"openalex","retrieved_at":"…","citation_count":42}}],"request":{"id":"req_…","filters":{"limit":5,"to_year":null,"from_year":2022,"open_access_only":false,"exclude_known_retracted":false},"price_usd":"0.03","retrieved_at":"2026-09-01T12:00:00.000Z","normalized_query":"retrieval-augmented generation reduce hallucinations"},"warnings":["Candidate evidence only; relevance and citation count do not establish truth or quality. A missing integrity warning does not prove a paper is sound."],"partial_failures":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HTHEGNlkgw7ReL5sFLRGZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds 3–10 scholarly paper candidates for a research question or topic, returning DOI/OpenAlex IDs, authors, year, venue, open-access URLs, citation counts, and retraction/correction warnings.","exampleAgentPrompt":"Can you find me 5 recent scholarly papers from 2020 onwards on whether retrieval-augmented generation reduces hallucinations in large language models? Only include open-access papers and flag any that have been retracted.","exampleUseCases":[{"title":"Fact-checking a scientific claim","prompt":"I need scholarly evidence for the claim that intermittent fasting improves metabolic health — can you pull 7 candidate papers from 2018 onwards, flag any retractions, and only show me open-access ones?"},{"title":"Building a literature review bibliography","prompt":"I'm writing a literature review on CRISPR gene editing for sickle cell disease. Find me up to 10 scholarly papers with DOIs and citation counts, published between 2015 and 2024, and flag any integrity issues."},{"title":"Grounding an AI-generated report","prompt":"My agent just wrote a report on social media's effect on teen mental health — can you find 5 peer-reviewed papers to back it up, with their DOIs and open-access links, from 2019 onwards?"}],"resultDescription":"A JSON object containing a list of up to 10 scholarly paper candidates, each with identifiers (DOI, OpenAlex ID), title, authors, year, venue, relevance score and reason, open-access URL and license, citation count with context note, integrity status (retraction/correction warnings from OpenAlex and CrossRef), and source URLs. Also includes request metadata, stats (latency, cache status, duplicates removed), and disclaimer warnings that candidates are not proof of any claim.","failureModes":["Query too short or vague — minimum 8 characters required, returns 400 validation error","No matching papers found for niche or highly specific query — returns empty papers array","Provider (OpenAlex/CrossRef) timeout or partial failure — returned in partial_failures field with reduced result set","Rate limiting or payment failure via x402 — returns 402 or 429 status","Retraction data may be incomplete — integrity 'none_found' does not guarantee paper validity"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ground a claim, report, or document in real scholarly literature with traceable DOIs and integrity checks — especially when you need retraction warnings, open-access links, and citation context in a single call. Prefer it over generic web search when you specifically need peer-reviewed sources with structured bibliographic metadata. Not suitable for retrieving full paper text or verifying a specific reference (use the sibling bibliography-verification endpoint for that).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:47.676Z","isFirstParty":false}