get
https://public-api.vidmob.com/v1/media/aperture/
This endpoint retrieves the status of a Creative Tags Job using the provided jobId. It returns details about the job, including its status, associated media, and processing results.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Retrieves the current status of a Creative Aperture annotation job, and returns the full annotation results once processing is complete.
Job status values
| Status | Meaning |
|---|---|
PENDING | Job is queued but not yet processing. |
PROCESSING | Annotation is in progress. Continue polling. |
COMPLETE | All assets have been annotated. Results are available in this response. |
FAILED | Job failed. Terminal state. |
What the results contain
When status is COMPLETE, the response includes the annotation output for each submitted asset. Results are structured as a set of detected tags per asset, which may include:
- Visual elements (objects, scenes, settings)
- People and emotions
- Text overlays and on-screen copy
- Brand signals (logos, colors, products)
- Client tags mapped back to the asset
Polling guidance
Poll at regular intervals — annotation processing time scales with the number and size of assets in the job. For small jobs (a handful of short videos), results may be available within minutes. For larger batches, check back every few minutes.
Scope required
scoring:read