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.
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/"
] }'{
"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
- 01
Create the campaign
POST /campaigns with the brief in plain text.
- 02
Set up the webhook
PATCH /campaigns/:id with the URL that receives reports.
- 03
Submit the videos
POST /campaigns/:id/verifications with up to 500 URLs.
- 04
Get the report
On the webhook, or by calling GET /verifications/:id.
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.