Validate Video

Validate video for ad campaigns (unified tool for all platforms).

⚠️ IMPORTANT: This is a READ-ONLY validation tool. Safe to call multiple times.

🎯 What This Tool Does:

Validates videos for Google Ads PMAX or TikTok campaigns
For PMAX: Validates YouTube video (privacy, duration, embeddable)
For TikTok: Validates public video URL is accessible
Returns metadata (title, duration, privacy, thumbnail)

DOES NOT upload videos - user must already have video uploaded:

PMAX: Video must be on YouTube (public or unlisted)
TikTok: Video must be on public hosting (Google Drive, Vimeo, etc.)

Parameters:

video_url_or_id (required): YouTube URL/ID (PMAX) or public video URL (TikTok)
platform (required): ‘pmax’ or ‘tiktok’

For PMAX: Accepts YouTube formats:

Full URL: https://youtube.com/watch?v=dQw4w9WgXcQ
Short URL: https://youtu.be/dQw4w9WgXcQ
Shorts: https://youtube.com/shorts/dQw4w9WgXcQ
Direct ID: dQw4w9WgXcQ (11 characters)

Validates:

Video exists and is accessible
Privacy is Public or Unlisted (NOT Private)
Embeddable is enabled
Duration ≥10 seconds (PMAX requirement)

Returns:

Video title
Duration
Privacy status
Thumbnail URL
Video ID

For TikTok: Accepts public video file URLs:

Google Drive: https://drive.google.com/file/d/ABC123/view
Vimeo: https://vimeo.com/video/123456
Dropbox: https://dropbox.com/s/abc/video.mp4
Any publicly accessible video URL

Validates:

URL is accessible (HTTP 200)
Content-Type is video/* (when available)

Returns:

URL validation status
Content-Type
File size (if available)

Execution Time: 1-3 seconds (YouTube Data API call or HTTP request)

When to Use:

BEFORE creating a campaign with videos
To verify video meets platform requirements
To get video metadata (title, duration)

Example Usage:

User: "I want to use this YouTube video in my PMAX campaign: dQw4w9WgXcQ"
YOU: [Call validate_video with video_url_or_id="dQw4w9WgXcQ", platform="pmax"]
Response: Video validated, title="Product Demo", duration=45s, ready for use

User: "Can I use this video for TikTok ads: https://drive.google.com/file/d/ABC/view"
YOU: [Call validate_video with video_url_or_id="https://drive...", platform="tiktok"]
Response: URL validated, accessible, ready for campaign

Error Handling:

Private videos: Clear error asking user to change privacy to Public/Unlisted
Short videos (<10s for PMAX): Error with duration requirement
Invalid URLs: Error with accessibility details
Not embeddable: Error asking user to enable embedding

POST

api

tools

validate_video

execute

Validate Video

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/validate_video/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "platform": "https://example.com",
    "video_url_or_id": "https://example.com"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for validate_video)"
  },
  "success": true,
  "tool": "validate_video"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for unified video validation

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Add LinkedIn Campaign To Group**USE THIS TOOL WHEN:** User wants to add a new campaign with DIFFERENT targeting/audience to an EXISTING campaign group. This is the LinkedIn equivalent of Meta's add_ad_set. LinkedIn hierarchy: Campaign Group → Campaign → Creative. - Different audiences = different Campaigns in the SAME Campaign Group. - Different creatives = different Creatives in the SAME Campaign. **Common scenarios:** - Audience testing: Same ad format, different targeting per campaign - Geographic split: Same creative, different locations per campaign - Multi-market: Same product, different countries - Scaling: Adding new audiences to existing campaign group **CRITICAL:** Each create_linkedin_*_campaign creates a new Campaign Group (unless campaign_group_id is passed). To add more campaigns to the SAME group, you MUST use this tool or pass campaign_group_id to create tools. NEVER call create_linkedin_*_campaign without campaign_group_id for the same group. **KEY DISTINCTION:** - Different audience/targeting → use THIS tool (new campaign in same group) - Different copy/creative, same audience → use add_linkedin_creative / add_linkedin_video_creative instead **Supports all 4 ad types:** image, video, carousel, text. Each campaign has INDEPENDENT: targeting, budget, schedule. Shared from campaign group: objective, group name. **Workflow:** 1. Create initial campaign → get campaign_group_id + campaign_id 2. Call this tool with campaign_group_id for each additional audience 3. Use add_linkedin_creative to add more creatives within any campaign Execution time: 15-120 seconds (depends on ad type)

Validate Video

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/validate_video/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "platform": "https://example.com",
    "video_url_or_id": "https://example.com"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for validate_video)"
  },
  "success": true,
  "tool": "validate_video"
}