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

# taap.it API Documentation

> Powerful link management and analytics API for developers

# Welcome to taap.it API

The **taap.it API** provides powerful programmatic access to our link management and analytics platform. Create, manage, and track deeplinks with enterprise-grade features and detailed analytics.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Get up and running with your first API call in under 5 minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Secure API key authentication with granular permissions
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/links">
    Complete documentation for all endpoints and features
  </Card>

  <Card title="Analytics" icon="chart-line" href="/api-reference/stats">
    Detailed insights and performance metrics for your links
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion title="Link Management" icon="link">
    * Create deeplinks with custom codes and domains
    * Password protection and expiration settings
    * UTM parameter templates and tracking pixels
    * Bulk operations and advanced filtering
  </Accordion>

  <Accordion title="Analytics & Insights" icon="chart-bar">
    * Real-time click tracking and unique visitor counts
    * Geographic and device analytics
    * Browser and referrer statistics
    * Exportable reports and data visualization
  </Accordion>

  <Accordion title="Advanced Features" icon="cog">
    * Password protection and expiration settings
    * UTM parameter tracking and templates
    * QR code generation with custom branding
    * Geographic restrictions and access control
  </Accordion>

  <Accordion title="Custom Domains" icon="globe">
    * Branded deeplinks with your domain
    * DNS verification and setup assistance
    * SSL certificate management
    * Domain performance monitoring
  </Accordion>
</AccordionGroup>

## Popular API Endpoints

<CardGroup cols={1}>
  <Card title="Links API" icon="link" href="/api-reference/links">
    **POST /v1/links** - Create, update, and manage deeplinks with advanced features like password protection and expiration dates.
  </Card>

  <Card title="Analytics API" icon="chart-line" href="/api-reference/stats">
    **GET /v1/stats/links/{id}** - Access comprehensive analytics including clicks, geographic data, and device statistics.
  </Card>

  <Card title="Domains API" icon="globe" href="/api-reference/domains">
    **POST /v1/domains** - Manage custom domains for branded deeplinks with DNS verification.
  </Card>

  <Card title="Projects API" icon="folder" href="/api-reference/projects">
    **POST /v1/projects** - Organize and group related links with project-based management.
  </Card>
</CardGroup>

## Quick Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST 'https://api.taap.it/v1/links' \
    -H 'Authorization: Bearer taapit_your_api_key_here' \
    -H 'Content-Type: application/json' \
    -d '{
      "original_url": "https://example.com/long-url",
      "custom_code": "my-link"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.taap.it/v1/links', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      original_url: 'https://example.com/long-url',
      custom_code: 'my-link'
    })
  });
  ```

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

  response = requests.post(
    'https://api.taap.it/v1/links',
    headers={
      'Authorization': f'Bearer {api_key}',
      'Content-Type': 'application/json'
    },
    json={
      'original_url': 'https://example.com/long-url',
      'custom_code': 'my-link'
    }
  )
  ```
</CodeGroup>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "id": "link_987654321",
    "original_url": "https://example.com/long-url",
    "short_url": "https://taap.it/my-link",
    "code": "my-link",
    "created_at": "2024-01-15T10:30:00Z",
    "click_count": 0,
    "is_active": true
  }
  ```
</ResponseExample>

## Base URL & Authentication

All API requests should be made to:

```
https://api.taap.it/v1
```

<Info>
  All requests require authentication using API keys. Include your API key in the Authorization header: `Bearer taapit_your_api_key_here`
</Info>

<Card title="Ready to get started?" icon="rocket" href="/quickstart">
  Follow our quickstart guide to make your first API call and start building with taap.it.
</Card>