Skip to main content

Datasets API

The Datasets API provides comprehensive dataset management capabilities for NER (Named Entity Recognition), text classification, and relation extraction tasks. It supports creating, listing, updating, deleting datasets, and uploading files in various formats (JSONL, CSV, Parquet, JSON).

Available Endpoints​


Getting Started​

Most Datasets API endpoints require authentication:

HeaderDescription
KnowledgatorAPI-KeyYour API key
Content-Typeapplication/json for JSON requests, multipart/form-data for file uploads

Example Usage​

SDK Usage​

💡 Dedicated SDK Guides: See Python SDK | TypeScript SDK

TypeScript/JavaScript​

import { createClient } from '@knowledgator/typescript-sdk';

const kg = createClient('YOUR_API_KEY');

// Use any of the datasets endpoints
const datasets = await kg.datasets.list();

Python​

from knowledgator import Knowledgator

kg = Knowledgator(api_key="YOUR_API_KEY")

# Use any of the datasets endpoints
datasets = kg.datasets.list()

cURL​

curl -X GET "https://api.platform.knowledgator.com/datasets/" \
-H "KnowledgatorAPI-Key: YOUR_API_KEY"

Dataset Types​

  • ner – Named Entity Recognition
  • text-classification – Text Classification
  • relation-extraction – Relation Extraction

Dataset Formats​

  • jsonl – JSON Lines (one JSON object per line)
  • csv – Comma-Separated Values
  • parquet – Apache Parquet columnar format
  • json – Standard JSON format

Dataset Status​

  • pending – Dataset created, awaiting processing
  • processing – Dataset is being processed
  • ready – Dataset is ready for use
  • failed – Processing failed

For detailed documentation on each endpoint, click on the links above.