List Raw Data
Retrieve a paginated list of all raw data items.
Endpoint
GET https://api.platform.knowledgator.com/data/
Headers
| Name | Type | Description |
|---|---|---|
KnowledgatorAPI-Key | String | Your API key |
Content-Type | String | application/json |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
offset | Integer | No | Pagination offset (default: 0, min: 0) |
limit | Integer | No | Maximum results per page (default: 100, max: 10000) |
name | String | No | Filter by name |
type | String | No | Filter by service type: ner, text-classification, relation-extraction |
format | String | No | Filter by format: jsonl, csv, parquet, json |
Response
{
"data": [
{
"id": "data-123",
"name": "Single Data Item",
"type": "ner",
"format": "jsonl",
"status": "ready",
"description": "Individual data item for NER",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"offset": 0,
"limit": 100
}
Response Fields
data: Array of raw data objectsid: Unique identifiername: Data nametype: Service type (ner, text-classification, relation-extraction)format: Data format (jsonl, csv, parquet, json)status: Current status (pending, processing, ready, failed)description: Optional descriptioncreated_at: ISO 8601 timestamp of creationupdated_at: ISO 8601 timestamp of last update
total: Total number of items matching the filteroffset: Current pagination offsetlimit: Current pagination limit
Error Codes
| Status Code | Description |
|---|---|
| 200 | OK – Request successful. |
| 400 | Bad Request – Invalid input or validation failed. |
| 401 | Unauthorized – Invalid API key. |
| 500 | Internal Server Error – Server-side issue. |
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');
const result = await kg.datasets.listData({
limit: 10,
type: 'ner'
});
console.log(result.data);
Python
from knowledgator import Knowledgator
kg = Knowledgator(api_key="YOUR_API_KEY")
result = kg.datasets.list_data(
limit=10,
type="ner"
)
print(result.data)
Python
import requests
url = "https://api.platform.knowledgator.com/data/"
headers = {
"KnowledgatorAPI-Key": "YOUR_API_KEY"
}
params = {
"limit": 10,
"type": "ner"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
cURL
curl -X GET "https://api.platform.knowledgator.com/data/?limit=10&type=ner" \
-H "KnowledgatorAPI-Key: YOUR_API_KEY"
Additional Information
- Pagination: Use
offsetandlimitparameters to browse large data sets. - Filtering: Combine multiple filters to find specific records.
- Use Cases:
- Monitoring individual data items
- Browsing data history
- Integrating with external data management systems