# Influtics API Documentation

Influtics lets you track influencer video performance across **10 platforms** with a single REST API. Use our collection endpoints to ingest new videos, read analytics, and automate reporting right from your stack. See the full [Supported Platforms](platform-support.md) list.

## Quick Links

[!card layout="snap" icon="key" title="Authentication"](/api-reference/authentication.md)
[!card layout="snap" icon="tag" title="Pricing"](/pricing.md)
[!card layout="snap" icon="rocket" title="Track your first video"](/api-reference/videos/track.md)
[!card layout="snap" icon="globe" title="Platform support"](/platform-support.md)

!!!tip "Reading this site as Markdown"
Every page in this docs site is also served as raw Markdown — just append `.md` to any page URL
(for example, [`/api-reference/authentication.md`](https://docs.influtics.com/api-reference/authentication.md)).
Use the **Copy page** or **View as Markdown** actions in the top-right of every page, or jump straight
into a conversation with the **Open in ChatGPT** / **Open in Claude** actions — both pre-load a
prompt that tells the AI which docs site you're reading and asks which page or endpoint you need help with.
!!!

## Quick Start

### Step 1: Create Your Account
1. Log in to your [Influtics Dashboard](https://app.influtics.com)
2. Navigate to **Settings** → **API Keys**
3. Click **Generate New API Key**
4. Copy your API key and store it securely

!!!warning
Never share your API key or commit it to version control. Use environment variables to store your key.
!!!

### Step 2: Make Your First Requests

#### Authenticate
```bash
curl -X GET https://api.influtics.com/v1/account/usage \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

#### Track a Video
```bash
curl -X POST https://api.influtics.com/v1/videos/track \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "url": "https://www.tiktok.com/@username/video/1234567890"
      }
    ]
  }'
```

#### Track Multiple Videos (Batch)
```bash
curl -X POST https://api.influtics.com/v1/videos/track \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "url": "https://www.tiktok.com/@user1/video/1111111111"
      },
      {
        "url": "https://www.instagram.com/reel/ABC123DEF456/",
        "tags": ["lifestyle"],
        "ecpm": 1.75
      },
      {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
      }
    ]
  }'
```

!!!warning "Legacy `{ "urls": [...] }` shape is deprecated"
The legacy shape still works until **2026-10-25** and emits `Deprecation: true` / `Sunset` response headers. New integrations should send the `videos[]` shape above — see [`POST /v1/videos/track`](/api-reference/videos/track.md) for the full request schema.
!!!

### Step 3: Pricing & Limits
- **Tracking new videos**: billed per video tracked
- **1000 videos** – $99
- **5000 videos** – $249
- **More than 5000 videos** – custom plans; [book a demo](https://cal.com/ivan-abramov-j5ivpd/influencer-marketing-demo)
- **Rate limits**: 20 multi-video requests/minute, 1000 total videos/minute

## Ready to get started?

[!card layout="snap" icon="play" title="Sign up now"](https://app.influtics.com/signup)
[!card layout="snap" icon="globe" title="See pricing on the website"](https://influtics.com/plans)

### Development Setup
```
INFLUTICS_API_KEY=your_api_key_here
INFLUTICS_BASE_URL=https://api.influtics.com
```

```javascript
const client = new InfluticsAPI(process.env.INFLUTICS_API_KEY)
await client.trackVideos([
  { url: 'https://www.tiktok.com/@user/video/123' },
])
```

```python
client = InfluticsAPI(os.getenv('INFLUTICS_API_KEY'))
result = client.track_videos([
  {'url': 'https://www.tiktok.com/@user/video/123'},
])
```

```php
$client = new InfluticsAPI($_ENV['INFLUTICS_API_KEY'])
$client->trackVideos([
  ['url' => 'https://www.tiktok.com/@user/video/123'],
])
```

## Built for automation
1. **Batch tracking** – import up to 50 videos per call with instant acknowledgment.
2. **Transparent billing** – credits are consumed only for fresh, uncached stats.
3. **Real-time analytics** – video stats refresh every few minutes for 30 days.
4. **Secure access** – simple API keys with bearer auth, rate limits, and audit-friendly responses.

## Testing Your Integration
1. Verify authentication: `GET /v1/account/usage`
2. Track videos: `POST /v1/videos/track`
3. Read stats: `GET /v1/videos/stats`

## Need help?

See the [Support](/support.md) page for email, Telegram, and demo booking.