# scopeapi.dev File Research

> scopeapi.dev File Research is a paid API for AI agents from scopeapi.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Analyzes and extracts evidence-grounded findings from an uploaded file in response to a natural language query

## Facts

- Endpoint: POST https://scopeapi.dev/file-research
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scopeapi-dev-file-research-82bad8d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dn2AbE4v4WQkrniEDyymk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scopeapi-dev-file-research-82bad8d4 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

File Research

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scopeapi-dev-file-research-82bad8d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scopeapi.dev](https://www.zero.xyz/host/scopeapi.dev/llms.txt)