# Dataville Docs

> Access trusted external datasets through Dataville's REST API and MCP server. Explore documentation for SEC EDGAR, Wikipedia, Census, arXiv, and AI applications.

- [Introduction](https://docs.dataville.com/introduction.md): One API for external data in AI applications, from Claude or from code.
- [Quickstart: Claude](https://docs.dataville.com/quickstart-claude.md): Add Dataville to Claude and ask for a company's most recent SEC filing.
- [Quickstart: API](https://docs.dataville.com/quickstart.md): Create an API key and make your first Dataville request in a few minutes.
- [Dashboard tour](https://docs.dataville.com/dashboard-tour.md): Watch a walkthrough of the Dataville dashboard, from sign-up to billing.
- [Connect AI Tools to Dataville's MCP Server](https://docs.dataville.com/ai-tools.md): Connect Claude, Claude Code, Cursor, Windsurf, or VS Code to Dataville's MCP server to access SEC EDGAR filings and Wikipedia data.
- [Who Dataville is for](https://docs.dataville.com/who-dataville-is-for.md): A database of vetted sources for fintech, insurance, consulting, and SaaS teams.
- [Data sources](https://docs.dataville.com/data-sources.md): Find the source you need, search it, and check its license.
- [SEC EDGAR filings](https://docs.dataville.com/edgar.md): Look up a company's most recent SEC filing, or list its filings over a date range.
- [Response format](https://docs.dataville.com/response-format.md): The JSON shape every data source returns.
- [Query with SQL](https://docs.dataville.com/query-with-sql.md): Run read-only SQL across sources, in Data Studio, over the API, or from DuckDB.
- [Query from DuckDB](https://docs.dataville.com/query-from-duckdb.md): Run SQL on Dataville from DuckDB and read the result as Parquet or CSV.
- [Connected data](https://docs.dataville.com/connected-data.md): Bring a Google Sheet into Dataville and query it alongside the public sources.
- [Plans and credits](https://docs.dataville.com/plans-and-credits.md): Check what a request costs and how far your monthly credits go.
- [Guides](https://docs.dataville.com/guides/overview.md): Explore practical tutorials for building AI applications with external data.
- [Verify Business Applications with Claude and SEC Filings](https://docs.dataville.com/guides/underwrite-from-claude.md): Verify business applications using Claude and Dataville's SEC EDGAR data. Check company details, revenue, and recent filings to identify discrepancies.
- [Automate SEC Filing Alerts with Python](https://docs.dataville.com/guides/filings-watchlist.md): Build an automated SEC filing watchlist using Python and Dataville's EDGAR API. Detect new 10-K, 10-Q, and 8-K reports and send alerts to Slack, Teams, or email.
- [Enrich Company Records with SEC EDGAR and Wikipedia APIs](https://docs.dataville.com/guides/onboarding-enrichment.md): Learn how to enrich company records using Dataville's API and Python. Retrieve SEC EDGAR filings and Wikipedia company information automatically during onboarding.
- [Analyze Competitors Using SEC EDGAR Filings](https://docs.dataville.com/guides/competitor-scan.md): Analyze competitor financials using SEC EDGAR filings. Build a reusable comparison table with Claude, Google Sheets, and Dataville SQL.
- [Query SEC EDGAR Filings with DuckDB](https://docs.dataville.com/guides/sector-dataset-duckdb.md): Learn how to query SEC EDGAR filings with DuckDB and Dataville's API. Join company filings with your own CSV data and export the results for analysis.
- [Build a Langflow Agent with SEC EDGAR and Wikipedia](https://docs.dataville.com/guides/langflow-wiki-sec-edgar.md): Build a Langflow AI research agent using Dataville's MCP server to combine SEC EDGAR financial filings with Wikipedia company information.
- [Classify CRM Accounts by Industry with Claude](https://docs.dataville.com/guides/tag-accounts-by-industry.md): Use Claude and Dataville's Wikipedia data to classify CRM accounts by industry. Match companies to source articles and export standardized industry tags as CSV.
- [Overview](https://docs.dataville.com/api-reference/overview.md): One REST API to search and query every source in Dataville's catalog.
- [Create an API key](https://docs.dataville.com/api-reference/authentication.md): Dataville's API authenticates using an API key.
- [Usage limits](https://docs.dataville.com/api-reference/usage-limits.md): Rate limits for the Dataville API.
- [Troubleshooting](https://docs.dataville.com/api-reference/errors.md): How the Dataville API reports errors and what to do about each one.
- [MCP server](https://docs.dataville.com/api-reference/mcp-server.md): Dataville's hosted MCP server is documented under Connect an AI tool.
- [Search a data source](https://docs.dataville.com/api-reference/data-sources/search-a-data-source.md): Search any supported data source by keyword and return the single most relevant result. This is the primary endpoint of the API.
- [Fetch an article by pasting its URL](https://docs.dataville.com/api-reference/data-sources/fetch-an-article-by-pasting-its-url.md): Paste a Wikipedia URL directly onto the API host and get the article back. The path is the URL with its double slash collapsed to one, so `https://en.wikipedia.org/wiki/Moon_landing` becomes:
- [List the query endpoints](https://docs.dataville.com/api-reference/export-and-sql/list-the-query-endpoints.md): Where to send SQL, as JSON or from a DuckDB client. No auth required.
- [Run a SQL SELECT across the datasets](https://docs.dataville.com/api-reference/export-and-sql/run-a-sql-select-across-the-datasets.md): Execute a read-only SQL query over the datasets in DuckDB. Only `SELECT` statements are accepted; anything else is rejected by the validator.
- [Run a SQL SELECT from DuckDB, result as Parquet](https://docs.dataville.com/api-reference/export-and-sql/run-a-sql-select-from-duckdb-result-as-parquet.md): The same query as `POST /api/v1/query` — same tables, validator and limits (10,000 characters, 1,000 rows, 30 seconds) — with the result returned as a Parquet file, so DuckDB can read it directly:
- [Run a SQL SELECT from DuckDB, result as CSV](https://docs.dataville.com/api-reference/export-and-sql/run-a-sql-select-from-duckdb-result-as-csv.md): `GET /api/v1/query.parquet` with a CSV result, for `read_csv` or any HTTP client. Same limits, billing and 5-minute uncharged re-reads.
- [Run SQL against one connected sheet](https://docs.dataville.com/api-reference/connected-sheets/run-sql-against-one-connected-sheet.md): A SELECT-only sandbox scoped to a single dataset. Reference the sheet as `sheet_data` in the SQL. Accepts an API key as well as a Clerk session, so connected data is queryable programmatically.
- [Keyword-search a connected sheet](https://docs.dataville.com/api-reference/connected-sheets/keyword-search-a-connected-sheet.md): Search every column of a connected sheet without writing SQL. Accepts an API key.
- [Get request usage for the caller](https://docs.dataville.com/api-reference/usage/get-request-usage-for-the-caller.md): Request counts and limits for the caller — authenticated by token, or by IP when no token is sent. Your credit balance is reported on every metered response in `X-Credits-Remaining` and on the dashboard's **Billing** page.
- [Are you an AI agent?](https://docs.dataville.com/api-reference/ai-agents.md): Direct links to the OpenAPI spec and other machine-readable forms of these docs.

## OpenAPI Specs

- [openapi](/openapi/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.