1. What APIs Does Vidmob Offer?
Vidmob offers a suite of APIs centered around our core competency: Creative Data. These APIs allow programmatic access to the rich, granular data we generate by analyzing the creative elements within your ads and their performance.
API Name | Core Function | Data Output |
Creative Tags API
| Allows you to upload your asset and get them processed through Vidmob AI to get tags back. Provides granularity by identifying and extracting hundreds of specific elements within an ad creative (e.g., scene changes, text overlay, duration, logo placement). | Structured JSON data detailing every analyzed creative element. |
Scoring External Assets | Allows you to upload your asset and get them processed through Vidmob AI. Provides a single-score metric that indicates creative quality or adherence to data-driven best practices | A numerical score (e.g., 1–100) and associated rule-level data. |
Creative Scoring API | Allows you to programmatically retrieve Scores for your in_flight, pre_flight or ad_account scorecards. | Structured JSON data detailing adherence scores by channel and criteria. |
2. Business Use Cases: Why Use the Vidmob APIs?
The primary purpose of the Vidmob APIs is to bring "Creative Intelligence" to the parts of your tech stack where data-driven decisions are made.
Use Case 1: Automating Pre-Flight Creative Vetting (Scoring External Assets)
The Goal: Ensure every creative meets brand and platform compliance before media spend is allocated.
The API Solution: Integrate the Scoring External Assets API into your creative production workflow or ad server QA process. Your team uploads a finished creative (not yet live) and instantly receives a score. Any asset scoring below a mandatory threshold is automatically flagged or blocked from deployment, saving media spend and ensuring brand safety.
Use Case 2: Enhancing Measurement and Attribution (Creative Scoring API)
The Goal: Prove the impact of creative quality on business outcomes (ROAS, lift, etc.).
The API Solution: Use the Creative Scoring API to pass the established Creative Quality Scores for your in-flight ads directly into your Marketing Mix Modeling (MMM), Multi-Touch Attribution (MTA) model, or custom uplift studies. By including the creative score as a quantifiable variable, you move beyond incomplete models to prove the incremental value of better creative.
Use Case 3: Powering Digital Asset Management (DAM) and Creative Discovery (Creative Tags API)
The Goal: Make your vast creative library searchable by what's inside the assets and how they performed.
The API Solution: Integrate the Creative Tags API into your DAM. As creatives are uploaded, Vidmob automatically tags them with granular elements (e.g., "features product shot at 0:05," "has a red background," "call-to-action is a discount code"). Your creative team can then search the DAM for the "best-performing, 15-second mobile assets featuring a logo and a clear CTA."
Use Case 4: Advanced BI and Real-Time Dashboard (Creative Scoring API & Creative Tags API)
The Goal: Visualize media performance segmented by creative features in your internal BI tools.
The API Solution: Use both APIs to ingest the creative tag data and performance scores alongside your existing media spend data. This allows you to build custom dashboards that answer critical optimization questions like:
What is the Cost Per Acquisition (CPA) difference between creatives where the logo was visible for 1 second versus 5 seconds?
Which rule categories (e.g., "Platform Best Practices" or "Brand Guidelines") have the lowest adherence scores in the past 7 days?
3. How to Start Using Vidmob APIs (Client-Facing Steps)
Getting started requires three main steps: Access, Authentication, and Integration.
Request and Generate Your API Key:
Contact your Vidmob Client Success Manager or navigate to the Data Management section in the Vidmob platform to generate your unique API Key. This key is essential for all authentication. How do I set up the Creative Scoring and Creative Tags APIs for all details.
Authenticate Your Requests:
Your development team must include the API Key in the header of every API request sent to Vidmob. This ensures security and validates that the request is coming from your authorized organization.
Implement the Integration Loop:
The general workflow involves sending a creative asset (or an ID for an existing asset) to the relevant Vidmob API endpoint. The API processes the request and returns the structured data (tags or scores) that your system then ingests to execute your specific business logic (filter, attribute, or visualize).
For detailed input/output structures, request bodies, and technical specifications, please refer to our technical documentation at vidmob-api-docs.readme.io/.