> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getclaro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claro API Reference

> This documentation enables developers to transform messy enterprise data into decision-ready insights through intelligent automation and AI-powered data processing using Claro’s REST APIs.

* **[Add Data Sources](/api-reference/upload-datasource)**: Upload and manage raw data files for cleaning and organization into structured tables
* **[Create Dataset](/api-reference/create-dataset)**: Store, organize, and manage millions of rows of unstructured data with full CRUD operations and export capabilities
* **[Dataset Management](/api-reference/manage-dataset)**: Full CRUD operations on datasets including data access, updates, and exports
* **[Create Task](/api-reference/tasks)**: Trigger AI-powered processing, enrichment, and analysis workflows on your datasets
* **[Manage Webhooks](/api-reference/webhooks)**: Trigger AI-powered processing, enrichment, and analysis workflows on your datasets

<Note>
  Make sure you have your API credentials ready before making any requests.
</Note>

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/getting_started">
    Get started with Claro and make your first API call
  </Card>

  <Card title="Upload Data Source" icon="upload" href="/api-reference/upload-datasource">
    Upload raw data for cleaning and organization into structured tables
  </Card>

  <Card title="Create Dataset" icon="database" href="/api-reference/create-dataset">
    Create datasets from your data sources for AI processing
  </Card>

  <Card title="Manage Datasets" icon="gear" href="/api-reference/manage-dataset">
    View, update, and manage your dataset structure and data
  </Card>

  <Card title="Dataset Tasks" icon="brain" href="/api-reference/tasks">
    Trigger AI processing and enrichment workflows on your datasets
  </Card>

  <Card title="API Authentication" icon="key" href="#authentication">
    Learn how to authenticate and secure your API requests
  </Card>
</CardGroup>

## Use Cases

<CardGroup cols={2}>
  <Card title="Product Catalog Enhancement" icon="shopping-cart" href="/getting_started#scenario-1-enrich-your-ecommerce-catalog-5-minutes">
    Transform incomplete supplier catalogs into rich, searchable product data
    with AI-powered enrichment
  </Card>

  <Card title="Supplier Data Standardization" icon="truck" href="/getting_started#scenario-2-accelerate-supplier-onboarding-5-minutes">
    Harmonize inconsistent data formats from suppliers and accelerate partner
    onboarding
  </Card>

  <Card title="SEO Content Generation" icon="search" href="/getting_started#scenario-3-scale-seo-content-creation-5-minutes">
    Generate SEO-optimized titles, descriptions, and metadata at scale for
    thousands of pages
  </Card>

  <Card title="Location Intelligence" icon="map-pin" href="/getting_started#scenario-4-enhance-location-data-for-business-intelligence-5-minutes">
    Add contextual data like demographics and competition analysis to location
    coordinates
  </Card>
</CardGroup>

## Authentication

All Claro API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header of each request.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://secure-api.getclaro.ai/api/v2/datasets \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"
  ```

  ```python Python theme={null}
  import requests

  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  response = requests.get(
      "https://secure-api.getclaro.ai/api/v2/datasets",
      headers=headers
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://secure-api.getclaro.ai/api/v2/datasets", {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  });
  ```
</CodeGroup>

## 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:

```json theme={null}
{
  "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:

* **[Support Email](mailto:hello@getclaro.ai)**: Get direct support from our team
* **[Platform Dashboard](https://app.prod.getclaro.ai/dashboard/)**: Access the web interface
* **[Getting Started Guide](/getting_started)**: Step-by-step tutorials and scenarios