{"uid":"cap_dn2AbE4v4WQkrniEDyymk","slug":"scopeapi-dev-file-research-82bad8d4","name":"scopeapi.dev File Research","description":"File Research","url":"https://scopeapi.dev/file-research","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query","file"],"properties":{"file":{"type":"string","format":"binary"},"query":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"file":{"name":"report.pdf","size":245760,"type":"application/pdf"},"usage":{"modelCallsUsed":1,"fileSearchCalls":1},"analysis":"Evidence-grounded findings extracted from the supplied document.","endpoint":"/file-research"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_CcGt_YwwcMds7kLEc4CJW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes and extracts evidence-grounded findings from an uploaded file in response to a natural language query","exampleAgentPrompt":"I have a PDF report called 'Q3_financials.pdf' — can you analyze it and tell me what the main revenue drivers were this quarter? Upload the file and run the question through file research.","exampleUseCases":[{"title":"Legal contract clause extraction","prompt":"I've uploaded a vendor contract as a PDF — can you read through it and tell me what the termination clauses and liability caps are?"},{"title":"Academic paper research query","prompt":"Here's a research paper on climate change I uploaded — what does it say about the projected sea level rise by 2050, and what evidence does it cite?"},{"title":"Financial report analysis","prompt":"I have an annual report PDF from a company I'm evaluating — can you go through it and pull out the key financial metrics, especially revenue growth and operating margins?"}],"resultDescription":"Returns a JSON object with the evidence-grounded analysis text answering the query, metadata about the uploaded file (name, size, MIME type), and usage stats showing how many model calls and file search calls were made.","failureModes":["Missing required 'query' or 'file' fields returns a validation error","Unsupported file format may cause parsing failure or empty analysis","File too large may exceed size limits and return an error","Ambiguous or overly broad queries may yield low-quality or generic analysis","Non-binary or malformed file upload causes a processing error"],"whenToPreferThis":"Use this endpoint when you have a specific file (PDF, document, etc.) that you want to query or extract evidence from using a natural language question. It is ideal when the source of truth is a document in hand rather than the open web. Choose this over web research endpoints when the user already possesses the document, or over generic text extraction when you need an AI-synthesized, evidence-grounded answer rather than raw text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:26.876Z","isFirstParty":false}