Registry

Look up photos in the user registry

Submit one or more images (URL or base64) and receive the full PhotoRecord for each. The record is the registry projection keyed by lens. Free endpoint, no credits charged.

When to use

Call this before POST /v2/analyze whenever you have image inputs. Any photo already in the registry (by exact SHA-256 or perceptual hash) comes back here for free, so you only spend credits on genuine cache misses. This is the registry-first path that makes repeat work cost zero.

Match tiers

  • exact: SHA-256 equality
  • fuzzy: pHash Hamming distance within threshold (default 5, max 64)
  • none: no registry entry; photo is omitted

Response shape

The results object is keyed by SHA-256. Each PhotoRecord.lenses is a map from lens name to the latest lens output (output, version, producedAt, coRunHash, provider).

post/v2/lookup

Request

  • Base URL: https://api.phototology.com
  • URL: https://api.phototology.com/v2/lookup
  • Auth: HTTP bearer

Request body

imagesstring[]
images_base64string[]
thresholdinteger

Response

Lookup complete. Each result carries the full PhotoRecord on exact/fuzzy matches.

object'lookup' required
resultsobject required

Changes

No recorded changes to this operation across all 1 revision of this API.