Skip to main content
  • Add Data Sources: Upload and manage raw data files for cleaning and organization into structured tables
  • Create Dataset: Store, organize, and manage millions of rows of unstructured data with full CRUD operations and export capabilities
  • Dataset Management: Full CRUD operations on datasets including data access, updates, and exports
  • Create Task: Trigger AI-powered processing, enrichment, and analysis workflows on your datasets
  • Manage Webhooks: Trigger AI-powered processing, enrichment, and analysis workflows on your datasets
Make sure you have your API credentials ready before making any requests.

Use Cases

Authentication

All Claro API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header of each request.
curl -X GET https://secure-api.getclaro.ai/api/v2/datasets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Base URL

All API endpoints are relative to the base URL:
https://secure-api.getclaro.ai/api/v2

Rate Limits

API requests are rate limited to ensure fair usage:
  • Standard plans: 100 requests per minute
  • Premium plans: 500 requests per minute
  • Enterprise plans: Custom limits available
Rate limit headers are included in all responses:
  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: Time when the rate limit resets

Error Handling

The API uses standard HTTP status codes and returns detailed error messages in JSON format:
{
  "error": "Data source not found",
  "code": "DATASOURCE_NOT_FOUND",
  "details": {
    "datasourceId": "invalid-uuid-format"
  }
}

Getting Help

Need assistance with the API? We’re here to help: