API Docs

Developer Platform

YouTube AI-Nexus REST API

Programmatically generate campaigns from any system. JSON over HTTPS, bearer-token authentication.

POST/api/v1/generate-campaign

Generate a multi-platform marketing campaign from a YouTube URL.

Request
{
  "video_url": "https://youtube.com/watch?v=XEzRZ35urlk",
  "markets": ["US", "IN", "JP"],
  "objectives": ["awareness", "consideration"],
  "tone": "energetic"
}
Response
{
  "campaign_id": "cmp_8f2a91",
  "status": "complete",
  "score": 94,
  "assets": {
    "headlines": ["The future is here.", "..."],
    "descriptions": ["..."],
    "thumbnails": ["https://cdn.ai-nexus/.../1.jpg"]
  }
}
GET/api/v1/campaigns

List all campaigns for the authenticated workspace.

Request
// Headers
Authorization: Bearer <YOUR_API_KEY>

// Query params (optional)
?status=complete&limit=20
Response
{
  "data": [
    {
      "id": "cmp_8f2a91",
      "name": "Pixel 8 Pro Launch — Global",
      "status": "complete",
      "score": 94,
      "created_at": "2026-06-16T10:22:00Z"
    }
  ],
  "next_cursor": null
}
POST/api/v1/localize

Adapt an existing campaign for additional markets with cultural intelligence.

Request
{
  "campaign_id": "cmp_8f2a91",
  "target_markets": ["BR", "FR", "DE"],
  "preserve_brand_voice": true
}
Response
{
  "localizations": [
    { "market": "BR", "language": "pt-BR", "headline": "..." },
    { "market": "FR", "language": "fr-FR", "headline": "..." },
    { "market": "DE", "language": "de-DE", "headline": "..." }
  ]
}
POST/api/v1/brand-safety-scan

Run a brand-safety and advertiser-friendliness analysis on a video.

Request
{
  "video_url": "https://youtube.com/watch?v=fmGfYFvOOFs",
  "guidelines": "google_default"
}
Response
{
  "safety_score": 98,
  "advertiser_friendly": true,
  "flags": [],
  "categories": {
    "violence": 0.01,
    "profanity": 0.0,
    "sensitive_topics": 0.04
  }
}
API access available for enterprise deployments.