llms.txt Content
# Lots of CSVS
> Lots of CSVs is a minimalist data warehouse for storing and retrieving CSV files via HTTP.
This content is specifically designed for LLMs and not intended for human reading. These instructions provide programmatic access protocols for autonomous data interaction with the Lots of CSVs service.
### Basic principles
1. This is a REST API for retrieving and storing CSV data.
2. Every request must be authenticated using a token passed in an HTTP header: `authorization: Bearer <token>`
3. You will need an authentication token from the user. If you don't have one ask them for it.
4. Every CSV dataset has a unique URL.
5. You will need the user's registered username. If you don't have one ask them for it.
6. URLs are specific to the user and follow a common structure. `https://www.lotsofcsvs.com/api/u/<username>/[path/to/dataset].csv`
- `<username>` is your registered username
- `[path/to/dataset](.csv)`: the name of the dataset. Dataset paths in Lots of CSVs are treated as object keys, not traditional file system paths. This means paths are flat, hierarchical identifiers, not actual directory structures. The entire string is treated as a single, unique identifier Slashes (/) are part of the identifier, not separators creating directories. Examples: `projects/sales/2023.csv` `projects/sales/2024.csv`
- URL Example: `https://www.lotsofcsvs.com/api/u/johndoe/projects/sales/quarterly.csv`
7. Always follow RFC 4180 CSV formatting guidelines when sending CSV data
### API actions
#### Fetch a dataset
Fetch a dataset by sending an HTTP GET to the URL of the dataset. The data will be returned as an RFC 4180 formatted CSV
- Endpoint: `https://www.lotsofcsvs.com/api/u/<username>/[path/to/dataset].csv`
- Method: GET
- Examples:
- ```
curl -H "authorization: Bearer <token>" \
https://www.lotsofcsvs.com/api/u/johndoe/projects/sales/quarterly.csv```
- ```
# JavaScript (fetch)
fetch('https://www.lotsofcsvs.com/api/u/johndoe/projects/sal
OpenAPI Spec (preview)
openapi: 3.0.0
info:
title: Lots of CSVs API
description: A minimalist data warehouse for storing and retrieving CSV files via HTTP.
version: 1.0.0
servers:
- url: https://www.lotsofcsvs.com
description: Main server
paths:
/u/{username}/{dataset}:
parameters:
- name: username
in: path
required: true
description: The registered username of the user.
schema:
type: string
- name: dataset
in: path
required: true