Find where a small pattern image (a button, icon, logo or crop) appears inside a

Find where a small pattern image (a button, icon, logo or crop) appears inside a larger screenshot or picture, using OpenCV cv2.matchTemplate. Returns the best position, plus every non-overlapping position scoring above the threshold, as pixel boxes with scores. Use it for exact-looking pixel patterns at the same scale; for different scale, rotation or perspective use /v1/homography.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://visionflow-match.saastemly.com/v1/template-match

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "image": "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",
    "max_matches": 5,
    "method": "TM_CCOEFF_NORMED",
    "template": "iVBORw0KGgoAAAANSUhEUgAAACQAAAAcCAAAAAAsQkKEAAAA+klEQVQ4y42SPQ6CUBCEZwktnsCOyhPYcw/tqLyAsREruAAX8AR2dvQmFlZaYeUJpNJGF/D9PyKTrLDyMcPbLNVodYLUhGsGQ4HN4Ml180GGZg7lgVwFdhp3jlUHzQ1o7gTacQd591aiRSbyzg/xfIqEf6tU9CFaKDvpHnigSmRzFXHZUWc6DFAc1Z0VXvaxl1zxzylEn/d/Th4j7LlqDSLv65WiAiICUeFCqTtMDxVLKzlxh9oqangLdiNXRVgpqBigDGj9d5hDnxSPWt/YgKy0j97Qvb9GWOl/52t5mgtvQQQ0UduXCsutzLBz6VVyrTayHT4dg01jQ19MuT6lPI4mjwAAAABJRU5ErkJggg==",
    "threshold": 0.8
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "grayscale": {
              "description": "Match on grayscale versions of both images (default false: match all three colour channels)",
              "type": "boolean"
            },
            "image": {
              "description": "Base64 of a PNG, JPEG, BMP or WebP file (a data: URI also works). At most 4 million pixels and about 2 MB. Alpha is dropped.",
              "type": "string"
            },
            "max_matches": {
              "description": "Most matches returned, 1-50 (default 5); overlapping positions are suppressed",
              "type": "integer"
            },
            "method": {
              "description": "OpenCV matching method (default TM_CCOEFF_NORMED, robust to brightness change). Scores are 0-1, higher is better; for TM_SQDIFF_NORMED the score is 1 minus the squared-difference value",
              "enum": [
                "TM_CCOEFF_NORMED",
                "TM_CCORR_NORMED",
                "TM_SQDIFF_NORMED"
              ],
              "type": "string"
            },
            "template": {
              "description": "Base64 of the pattern to find, same formats. At most 1 million pixels and about 1 MB. Must fit inside the image.",
              "type": "string"
            },
            "threshold": {
              "description": "Minimum score for a match, 0-1 (default 0.8)",
              "type": "number"
            }
          },
          "required": [
            "image",
            "template"
          ]
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON