{"uid":"cap_UoiWO8e2PL_W5XYA6s8Xf","slug":"citiview-document-q-a-ask-a-document-adf26b2e","name":"Citiview Document Q&A (Ask a Document)","description":"Ask a document: give a web page, PDF, Word, Excel or CSV URL (or raw text) and a question; get an answer backed by exact quotes from the document. Long documents are searched with embeddings first. Also callable as GET with the same fields as query parameters.","url":"https://agents.citiviewgroup.com/v1/ask?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["question"],"properties":{"url":{"type":"string","description":"Document or page URL"},"text":{"type":"string","description":"Raw text instead of url"},"question":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jQ45geGfesYgysNFh6sa_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Accepts a document URL or raw text plus a question, and returns a direct answer backed by exact quotes from the document, using embeddings for long-document search.","exampleAgentPrompt":"Look at this PDF — https://example.com/annual-report-2024.pdf — and tell me: what was the company's total revenue in 2024? I need the exact quote from the document.","exampleUseCases":[{"title":"Legal contract clause lookup","prompt":"Here's a contract PDF: https://example.com/vendor-contract.pdf — what does it say about termination notice periods? Give me the exact wording from the document."},{"title":"Research paper fact extraction","prompt":"I have a research paper at https://arxiv.org/pdf/2301.00001.pdf — what methodology did the authors use, and can you quote the relevant section?"},{"title":"CSV data policy question","prompt":"Look at this CSV file at https://example.com/product-specs.csv and tell me: which product has the highest warranty period? Quote the relevant row or cell."}],"resultDescription":"A natural language answer to the posed question, supported by exact verbatim quotes from the source document. For long documents, relevant sections are first retrieved via embeddings before generating the answer.","failureModes":["Document URL is inaccessible or returns a non-200 status — no content to parse","Unsupported file format beyond PDF, Word, Excel, CSV, or web page","Question field is missing — required parameter not provided","Document is too large or encoding is unreadable — parsing fails","Answer not found in document — model may indicate no relevant content","Rate limiting or payment failure at $0.02 USDC per call"],"whenToPreferThis":"Prefer this endpoint when you need a grounded, quote-backed answer from a specific document (PDF, Word, Excel, CSV, or web page) rather than a general web search or open-ended generation. Especially useful when accuracy and traceability to source text matter, such as legal review, financial document analysis, or research extraction. Choose this over generic chat completions when you need the answer to be anchored to a particular document's content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:48:38.715Z","isFirstParty":false,"canonicalSlug":"citiview-document-q-a-ask-a-document-adf26b2e"}