AiVidect Logo AiVidect

API Documentation

Integrate AI video detection into your application

Quick Start

Get started with the AiVidect API in minutes. API access is available on Pro and Business plans.

# Analyze a video URL curl -X POST https://aividect.com/api/analyze \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com/video.mp4"}'

Rate Limits

Pro: 100 requests/day  |  Business: 1,000 requests/day  |  Enterprise: Custom limits

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from your account settings.

Endpoints

POST /api/analyze Pro+

Analyze a video from a URL. Supports YouTube, TikTok, Instagram, Twitter, and direct video links.

Request Body

Parameter Type Description
url required string URL of the video to analyze
include_signals optional boolean Include detailed detection signals (default: false)

Example Request

curl -X POST https://aividect.com/api/analyze \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://youtube.com/watch?v=example"}'
import requests response = requests.post( "https://aividect.com/api/analyze", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={"url": "https://youtube.com/watch?v=example"} ) result = response.json() print(f"Verdict: {result['verdict']}") print(f"Confidence: {result['confidence']}%")
const response = await fetch('https://aividect.com/api/analyze', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ url: 'https://youtube.com/watch?v=example' }) }); const result = await response.json(); console.log(`Verdict: ${result.verdict}`);

Response

{ "success": true, "verdict": "AI-Generated", "confidence": 94.2, "risk_level": "High", "prob_fake": 0.942, "prob_real": 0.058, "generator": "sora", "processing_time_ms": 4523, "report_id": "#A7F3B2C1" }
POST /api/upload Business+

Upload and analyze a video file directly. Maximum file size: 200MB.

Request

Send as multipart/form-data with the video file.

curl -X POST https://aividect.com/api/upload \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "video=@/path/to/video.mp4"
POST /api/feedback All Plans

Submit feedback on an analysis result. Helps improve our model accuracy.

Request Body

Parameter Type Description
video_hash required string SHA256 hash of the analyzed video
user_label required string Your assessment: "real" or "fake"
comment optional string Additional context or notes

Response Codes

Code Description
200 Success - Analysis complete
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing API key
403 Forbidden - Plan doesn't include API access
429 Rate Limited - Daily quota exceeded
500 Server Error - Try again later

Ready to integrate?

Get API access with a Pro or Business subscription

View Pricing

Need Help?

Having trouble with the API? Check out our FAQ or contact our support team.