---
title: "What data exists"
method: GET
path: "/api/v1/datasets"
tags: ["AlphaYou"]
---

# What data exists

`GET /api/v1/datasets`

## Request

- Base URL: `https://api.alphayou.net`
- URL: `https://api.alphayou.net/api/v1/datasets`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

The catalog of datasets and the tool that returns each one, with its plan and cost. Costs no requests, so an agent can call it first to decide what to call next. Optional q filters by a word.

Plans: Free, Pro.

## Query parameters

- `q` string

## Response `200`

The requested records.

## Other responses

- `401`: Missing, unrecognised or revoked API key (error key_revoked).
- `403`: This key's plan does not include this endpoint, or the key has been suspended (error key_suspended).
- `404`: Not an endpoint an API key may call.
- `429`: Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again.
- `503`: The request budget could not be checked right now. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/alphayou/apis/alphayou-api.md) · [All operations](https://skmtc.dev/alphayou/apis/alphayou-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphayou/apis/alphayou-api/revisions/cde9e990c368?raw)