OnBriefing for developers

The influencer video verification API

Send the brief and the URLs of TikTok, Instagram and YouTube videos. Get back a structured report, rule by rule, with evidence, by webhook or polling.

Submit videos for verification
curl -X POST https://onbriefing.com/api/v1/campaigns/$CAMPAIGN_ID/verifications \
  -H "Authorization: Bearer $ONBRIEFING_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "urls": [
    "https://www.tiktok.com/@creator/video/7300000000000000001",
    "https://www.instagram.com/reel/ABC123/"
  ] }'
Webhook: verification.completed
{
  "event": "verification.completed",
  "verification": {
    "id": "cm8x2k...",
    "status": "COMPLETED",
    "verdict": "REJECTED",
    "summary": "Shows the product and uses the hashtag, but doesn't mention the code.",
    "findings": [
      { "ruleText": "Say the promo code SUMMER26 out loud",
        "status": "FAIL", "severity": "MAJOR", "confidence": 0.86 }
    ]
  }
}

Integration in four calls

  1. 01

    Create the campaign

    POST /campaigns with the brief in plain text.

  2. 02

    Set up the webhook

    PATCH /campaigns/:id with the URL that receives reports.

  3. 03

    Submit the videos

    POST /campaigns/:id/verifications with up to 500 URLs.

  4. 04

    Get the report

    On the webhook, or by calling GET /verifications/:id.

See the full quickstart →

Built to run in production

REST + JSON

Six endpoints, Bearer token authentication. No SDK required: any language with HTTP works.

Batches of up to 500 videos

One call queues hundreds of URLs, with a per-line result. Nothing fails as a block.

Signed webhook

Get the report as soon as the analysis finishes, with an HMAC-SHA256 signature and automatic retries.

Safe resubmission

The same URL in the same campaign comes back as duplicate. Your retry never charges twice.

Structured report

Verdict, summary and one line per rule, with status, severity, confidence and citable evidence.

Failures aren't charged

If the analysis fails (private, removed or unavailable video), the credit goes back to the balance.

Who integrates

Creator and UGC platforms

Validate the creator's deliverable before releasing payment, right inside your platform's flow.

Affiliate programs

Check affiliate videos against program rules at scale, without a manual queue.

Campaign management tools

Add automatic brief verification to your product, with the report inside your interface.

Start integrating today.

Create an account, generate a key in Settings and make your first call in minutes. 10 free videos, then plans from $20/month, API included.

Talk to us

Tell us about your campaign. We reply by email.

We only use this to reply to you.