Find template

POST /api/image-find-template

Locate a template image inside a larger one. Returns the best match position and a confidence score. Useful for UI testing and finding logos in screenshots.

Searches a larger image for occurrences of a smaller template. Returns the position and confidence score of the best match (and optionally the top-N matches). Use cases: - UI test automation (find a button in a screenshot). - Logo / watermark detection. - Template-based object localisation. For more flexible visual matching (with rotation, scale, or lighting differences) see `image-match-features`.

Inputs

Name	Type	Default	Description
image*	file	—	Haystack image bytes.
template*	file	—	Template (needle) image bytes — must be smaller than `image`.
method	enum (ccoeff_normed \| sqdiff_normed \| ccorr_normed)	"ccoeff_normed"	Matching method.
threshold	number (-1…1)	0	Optional score threshold for `found` (default 0 = always report).

Response

Modes: json. Cache: yes (24h TTL).