Developer API — LabelSets

API Keys

Use your API key to query datasets, check license compatibility, and access quality scores programmatically. Pass keys in the X-Api-Key header.

Create New Key

Key name (e.g. "Production Pipeline")

Scopes

Free tier: 100 req/day · Pro tier (sellers with active listings): 2,000 req/day

Your Keys

🔑

Loading…

API Usage

Request counts reset daily at midnight UTC.

—

Requests Today

—

All-Time Requests

—

Active Keys

Per-Key Breakdown

API Reference

Base URL: https://initialdeploy-production.up.railway.app

Authentication

Every request must include your API key in the X-Api-Key header. Alternatively pass as ?api_key= query parameter.

curl https://initialdeploy-production.up.railway.app/v1/datasets \
  -H "X-Api-Key: ls_live_your_key_here"

Rate limit headers are returned on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

Method	Path	Description
GET	/v1/datasets	List & search published datasets. Filter by category, license, LQS tier, compliance, price. Paginated.
GET	/v1/datasets/:id	Single dataset detail. Accepts UUID or slug.
GET	/v1/datasets/:id/quality	Full LQS breakdown — composite score, 7 dimensions, badge URL.
GET	/v1/datasets/:id/license	Machine-readable license record — permissions, compliance, provenance.
GET	/v1/categories	All dataset categories with counts.
POST	/v1/licenses/compatibility	Check legal compatibility of 2–10 datasets. Returns verdict + combined terms.
GET	/v1/me	API key owner profile + usage stats.

Query Parameters — GET /v1/datasets

Param	Type	Description
`q`	string	Full-text search on title and description
`category`	string	Filter by category (case-insensitive)
`format`	string	Filter by format (csv, json, yolo, etc.)
`license`	string	License type contains this string
`lqs_min`	number	Minimum LQS score (0–100)
`lqs_tier`	string	platinum \| gold \| silver \| bronze
`hipaa`	boolean	true = HIPAA compliant only
`gdpr`	boolean	true = GDPR compliant only
`price_max`	number	Maximum price in dollars
`sort`	string	created_at \| price \| quality_score \| total_sales
`order`	string	asc \| desc (default: desc)
`page`	number	Page number (default: 1)
`per_page`	number	Results per page, max 100 (default: 20)

Code Snippets

Replace YOUR_API_KEY with your actual key.

Search Datasets

curl "https://initialdeploy-production.up.railway.app/v1/datasets?q=medical&lqs_min=70&hipaa=true" \
  -H "X-Api-Key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://initialdeploy-production.up.railway.app/v1/datasets",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"q": "medical", "lqs_min": 70, "hipaa": "true", "per_page": 20}
)
data = resp.json()
for ds in data["data"]:
    print(ds["title"], "— LQS:", ds["quality"]["composite"])

const res = await fetch(
  'https://initialdeploy-production.up.railway.app/v1/datasets?q=medical&lqs_min=70&hipaa=true',
  { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { data, meta } = await res.json()
console.log(`${meta.total} results, showing ${data.length}`)
data.forEach(ds => console.log(ds.title, ds.quality.tier))

Get Quality Score

curl "https://initialdeploy-production.up.railway.app/v1/datasets/DATASET_ID/quality" \
  -H "X-Api-Key: YOUR_API_KEY"

License Compatibility Check

curl -X POST "https://initialdeploy-production.up.railway.app/v1/licenses/compatibility" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dataset_ids": ["ID_1", "ID_2"], "use_case": "training"}'

Response Format

{
  "data": [
    {
      "id": "uuid",
      "slug": "medical-chest-xray-10k",
      "title": "Medical Chest X-Ray Dataset",
      "category": "Medical Imaging",
      "format": "DICOM",
      "price": 299,
      "item_count": 10000,
      "license": "CC BY-NC 4.0",
      "quality": { "composite": 84, "tier": "gold" },
      "compliance": { "hipaa": true, "gdpr": false },
      "stats": { "total_sales": 47, "avg_rating": 4.8 },
      "urls": {
        "dataset": "https://labelsets.ai/dataset.html?id=uuid",
        "license": "https://labelsets.ai/license.html?id=uuid",
        "badge":   "https://initialdeploy-production.up.railway.app/api/badge/uuid"
      },
      "created_at": "2025-11-14T09:22:00Z"
    }
  ],
  "meta": { "total": 142, "page": 1, "per_page": 20, "has_more": true }
}