End-to-end examples

curl -X POST "https://api.datasets.nordicdevhouse.com/v1/datasets/finnish-vehicle-market-listings/query" \
  -H "Authorization: Bearer $DATASET_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-API-Version: 1" \
  -d '{
    "release_id": "dsv-preview-finnish-vehicle-market-listings",
    "filters": { "make": "Toyota" },
    "fields": ["make", "model", "year", "price_eur"],
    "limit": 50
  }'

import os
import requests

base_url = "https://api.datasets.nordicdevhouse.com/v1"
headers = {
    "Authorization": f"Bearer {os.environ['DATASET_API_KEY']}",
    "X-API-Version": "1",
}

catalog = requests.get(f"{base_url}/datasets", headers=headers, timeout=20)
catalog.raise_for_status()
dataset = catalog.json()["data"][0]
release_id = dataset["latest_release"]["id"]

response = requests.post(
    f"{base_url}/datasets/{dataset['id']}/query",
    headers={**headers, "Content-Type": "application/json"},
    json={"release_id": release_id, "limit": 100},
    timeout=30,
)
response.raise_for_status()
print(response.json())

const baseUrl = "https://api.datasets.nordicdevhouse.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.DATASET_API_KEY}`,
  "X-API-Version": "1",
};

const catalogResponse = await fetch(`https://api.datasets.nordicdevhouse.com/v1/datasets`, { headers });
if (!catalogResponse.ok) throw new Error(`Catalog failed: ${catalogResponse.status}`);
const [dataset] = (await catalogResponse.json()).data;

const queryResponse = await fetch(`${baseUrl}/datasets/${dataset.id}/query`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ release_id: dataset.latest_release.id, limit: 100 }),
});
if (!queryResponse.ok) throw new Error(`Query failed: ${queryResponse.status}`);
console.log(await queryResponse.json());