DataBazaar Datasets API
The Datasets API from DataBazaar — 9 operation(s) for datasets.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/databazaar-io:databazaar-io-datasets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DataBazaar Datasets API
version: 1.0.0
description: REST API for discovering and purchasing datasets. Used by AI agents.
servers:
- url: https://api.databazaar.io
description: Production
security:
- bearerAuth: []
tags:
- name: Datasets
paths:
/datasets/check-duplicates:
post:
summary: Find matching datasets owned by the authenticated publisher
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- title
properties:
title:
type: string
responses:
'200':
description: Matching own-account listings, with IDs and similarity scores
'403':
description: Publisher is not approved
tags:
- Datasets
operationId: postDatasetsCheckDuplicates
x-operation-id-source: derived
/datasets/{id}/updates:
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
get:
summary: Read own dataset version and replacement history
responses:
'200':
description: Dataset metadata and latest update attempts
'404':
description: Dataset not owned by this account
tags:
- Datasets
operationId: getDatasetsByIdUpdates
x-operation-id-source: derived
post:
summary: Stage a replacement file for an active dataset
description: Accepts human JWTs, API keys/OAuth and verified owner-linked agent sessions. Upload the complete file to the returned upload_url, then submit it. No live data is changed yet.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- file_name
- file_size
- format
properties:
file_name:
type: string
maxLength: 255
file_size:
type: integer
minimum: 1
maximum: 268435456
format:
type: string
maxLength: 20
notes:
type: string
maxLength: 2000
coverage_label:
type: string
maxLength: 150
responses:
'201':
description: update_id, upload_url, path and submit_endpoint
'409':
description: Dataset cannot be replaced in its current state
tags:
- Datasets
operationId: postDatasetsByIdUpdates
x-operation-id-source: derived
/datasets/{id}/updates/{updateId}/submit:
post:
summary: Check and publish an uploaded replacement
description: Idempotently queues content checks, schema/sample regeneration and an atomic version switch. Old data stays live until checks pass; identical content does not advance freshness.
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
- name: updateId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Already processing or terminal
'202':
description: Queued for checks; poll update history
'409':
description: Another update is already pending
tags:
- Datasets
operationId: postDatasetsByIdUpdatesByUpdateIdSubmit
x-operation-id-source: derived
/datasets:
get:
summary: Search datasets
security: []
parameters:
- name: query
in: query
schema:
type: string
- name: category
in: query
schema:
type: string
- name: max_price
in: query
schema:
type: number
- name: min_quality_score
in: query
description: 'Minimum sample structure score (0–100). Unassessed listings are excluded. Methodology: https://databazaar.io/quality'
schema:
type: number
minimum: 0
maximum: 100
- name: pricing_type
in: query
schema:
type: string
enum:
- buy_it_now
- auction
- hybrid
- name: limit
in: query
schema:
type: integer
default: 20
- name: offset
in: query
schema:
type: integer
default: 0
responses:
'200':
description: List of datasets
tags:
- Datasets
operationId: getDatasets
x-operation-id-source: derived
/datasets/{id}:
get:
summary: Get a single dataset by ID
security: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Dataset detail
'404':
description: Dataset not found
tags:
- Datasets
operationId: getDatasetsById
x-operation-id-source: derived
/datasets/{id}/sample:
get:
summary: Download sample rows for a dataset
security: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Sample data (JSON or CSV depending on dataset format)
'404':
description: Dataset not found or no sample available
tags:
- Datasets
operationId: getDatasetsByIdSample
x-operation-id-source: derived
/datasets/{id}/buy:
post:
summary: Purchase a dataset at its buy-it-now price
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- payment_method_id
properties:
payment_method_id:
type: string
description: Stripe PaymentMethod ID (e.g. pm_...)
example: pm_1OqLh2LkdIwHu7ixVoK3AAAA
responses:
'201':
description: Purchase created; payment held in escrow
'400':
description: Invalid request or dataset not available for purchase
'402':
description: Payment failed
'404':
description: Dataset not found
tags:
- Datasets
operationId: postDatasetsByIdBuy
x-operation-id-source: derived
/datasets/{id}/download-url:
get:
summary: Download a free dataset (account required)
description: Returns a signed download URL for free datasets (price = $0). Account authentication required. For paid datasets, use the purchase flow via /datasets/{id}/buy.
security:
- bearerAuth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: JSON with download_url (signed, 1hr expiry) and expires_in
'401':
description: Account authentication required
'402':
description: Dataset is not free — purchase required
'403':
description: Agent owner approval required
'404':
description: Dataset not found
tags:
- Datasets
operationId: getDatasetsByIdDownloadUrl
x-operation-id-source: derived
/datasets/{id}/profile:
get:
summary: Get machine-readable data profile
description: Column statistics, quality scores, and completeness metrics. No auth required.
security: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Data profile with column stats
'404':
description: Dataset not found
tags:
- Datasets
operationId: getDatasetsByIdProfile
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer