Quickstart: API

Getting started with Dataville takes just a few minutes. This guide will walk you through getting an API key and making your first request to Dataville’s search a data source endpoint.

Create an account

Create your Dataville account

Sign-up for free.

Get your API key

An API key is automatically generated for you when you create a Dataville account. You can find it on the API keys page. Each account has one active key at a time.

The API Keys page in the Dataville dashboard. A Create API Key panel sits above a table of keys showing name, key prefix, status, last used, created date, and Reveal, Copy, and Revoke actions, with the Copy action highlighted.

Make a request

Search a source by putting its name and your keywords in the path, and send your key in the Authorization header. This request asks the arxiv source for a paper by its arXiv id:

curl "https://api.dataville.com/arxiv/1706.03762" \
  -H "Authorization: Bearer $DATAVILLE_API_KEY"

const response = await fetch(
  "https://api.dataville.com/arxiv/1706.03762",
  { headers: { Authorization: `Bearer ${process.env.DATAVILLE_API_KEY}` } },
);
const result = await response.json();

import os, requests

response = requests.get(
    "https://api.dataville.com/arxiv/1706.03762",
    headers={"Authorization": f"Bearer {os.environ['DATAVILLE_API_KEY']}"},
)
result = response.json()

To learn more about searching data sources, including every parameter and the sources you can pass, see the search a data source API reference.

Read the response

Dataville’s API will return the most relevant result from your selected data source. Every source returns data in the same format, so the code you write to read it works for all of them.

{
  "status": "success",
  "account_state": "authenticated",
  "data": {
    "id": "arxiv_1706.03762",
    "title": "Attention Is All You Need",
    "body": "Authors: Ashish Vaswani, Noam Shazeer, Niki Parmar, Jakob Uszkoreit, Llion Jones … (+3 more)\nPublished: 2017-06-12\nCategories: cs.CL, cs.LG\n\nThe dominant sequence transduction models...",
    "source": "arxiv",
    "metadata": {
      "arxiv_id": "1706.03762",
      "abs_url": "http://arxiv.org/abs/1706.03762v7",
      "categories": ["cs.CL", "cs.LG"]
    }
  },
  "usage": {
    "credits_total": 5,
    "credits_remaining": 4.995,
    "credits_used": 0.005,
    "request_cost": 0.005
  }
}

The data.body field contains the entire result’s body and can be passed straight into models. Structured metadata specific to each source is accessible through data.metadata.

Next steps

Now you’ve queried Dataville’s API, you’re ready to integrate it into your workflows.

Data sources

Find the source that has what you need.

Connect an AI tool

Search every source from Claude, Cursor, Windsurf, or VS Code.

Export datasets

Download a whole source instead of one record at a time.

Monitor SEC filings for a watchlist

A script that checks companies for new filings every weekday morning.

Get started

Data

Working with data

Account

Create your Dataville account

Next steps

Data sources

Connect an AI tool

Export datasets

Monitor SEC filings for a watchlist

Create your Dataville account

​Next steps

Data sources

Connect an AI tool

Export datasets

Monitor SEC filings for a watchlist

Next steps