{"uid":"cap_T3oLio_MbZdg0qf9WFuee","slug":"agentstools-scholar-search-bbf2f092","name":"AgentsTools Scholar Search","description":"Search the scholarly literature by keyword or topic and get a ranked list of works with core metadata. Optional filters for year range, open-access only, concept and institution. Powered by OpenAlex. A cheap first step before /scholar/paper.","url":"https://api.agentstools.dev/scholar/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Max items to return, default 10"},"query":{"type":"string","description":"Keyword or topic search terms"},"concept":{"type":"string","description":"Filter by a subject concept name"},"oa_only":{"type":"boolean","description":"Restrict to open-access works when true"},"year_to":{"type":"integer","description":"Latest publication year to include"},"year_from":{"type":"integer","description":"Earliest publication year to include"},"institution":{"type":"string","description":"Filter by an author institution name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6hchE2g6MwysNOUWreDiB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search scholarly literature by keyword or topic and return a ranked list of academic works with core metadata, powered by OpenAlex.","exampleAgentPrompt":"Search the scholarly literature for papers on 'transformer attention mechanisms in NLP', limit to the top 10 results from 2018 to 2024, open-access only, and filter by the concept 'natural language processing'.","exampleUseCases":null,"resultDescription":"A ranked list of academic works with core metadata including titles, authors, publication years, DOIs, open-access status, citation counts, and concept tags — up to the requested limit (default 10, max 50).","failureModes":["Empty result set if query terms are too niche or misspelled","No results when year_from/year_to range excludes all matching works","Institution or concept name not recognized by OpenAlex returns empty or unfiltered results","query parameter missing — required field causes 400-level error","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint as a cheap first step when you need to discover relevant academic papers by keyword or topic before fetching full details. Prefer this over /scholar/paper when you don't yet have a specific paper ID and need to survey the landscape. Ideal for literature reviews, research discovery, or finding open-access papers within a date range or from a specific institution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:10.935Z","isFirstParty":false}