Retrieve an image score
Poll for the result of a previously submitted image.
/v1/images/{image_id}/scoreReturns the current scoring state of an image previously sent to
Submit an image for scoring. Poll until
status moves from processing to scored.
Hero images return a score_metadata breakdown alongside
vizit_score; carousel images return vizit_score only.
Authorization
bearerAuth Short-lived access token issued by Create a token.
Send it on every request as Authorization: Bearer <token>.
In: header
Path Parameters
The image_id returned by Submit an image for scoring.
uuidResponse Body
application/json
application/json
curl -X GET "https://ext.vizit.com/v1/images/497f6eca-6276-4993-bfeb-53cbbbba6f08/score"{ "image_id": "84c230fd-5520-4984-8119-37365b66fd80", "status": "processing", "vizit_score": 0, "conversion_ready": true, "score_metadata": { "heroism": 0.1, "category_edge": 0.1, "technical_integrity": 0.1, "local_support": 0 }, "hero_gs1_components": { "property1": 0, "property2": 0 }, "mobile_readiness": { "brand_clarity": 0, "product_type_clarity": 0, "variant_clarity": 0, "count_clarity": 0, "size_clarity": 0, "mobile_ready": true }, "classification": "Lifestyle"}{ "detail": "string", "status_code": 0, "error_code": "INVALID_GTIN", "request_id": "266ea41d-adf5-480b-af50-15b940c2b846", "extra": { "failed_urls": [ { "url": "https://cdn.example.com/broken.jpg", "reason": "IMAGE_DOWNLOAD_TIMEOUT" }, { "url": "https://cdn.example.com/icon.svg", "reason": "UNSUPPORTED_IMAGE_FORMAT" } ] }, "timestamp": "2019-08-24T14:15:22Z"}POSTSubmit an image for scoring
Submits a standalone image for asynchronous scoring. The response returns immediately with an `image_id` and `status: processing`; use [Retrieve an image score](/api/images/getImageScore) to poll for the result. Hero images return a `score_metadata` breakdown alongside the composite `vizit_score`; carousel images return `vizit_score` only.
POSTRequest a Spark Idea
Queues a Spark Idea for the image and returns immediately with `status: processing` — a fresh request starts in flight, and an idempotent reuse only ever matches an in-flight Idea. Use [Retrieve a Spark Idea](/api/spark-ideas/getSparkIdea) to poll for terminal states (`completed` / `failed`). Idempotent on `image_id`: while an Idea is in flight for the image, subsequent calls return the existing Idea with `200 OK` instead of creating a new one. A fresh create returns `202 Accepted`. The organization check runs before the idempotent lookup, so callers from a different organization cannot reuse another org's in-flight Idea — they get `404 IMAGE_NOT_FOUND` instead.