Search images by upload

POST/api/v1/jobs/{id}/image-search

Uploads a reference image and returns perceptual-hash matches within a completed job result.

POSThttps://imageextract.com/api/v1/jobs/{id}/image-search

Auth

Project API key or signed-in browser session

Path parameters

uuid

Job id.

Example: f5ffd46b-9823-4885-89fc-db1dc80b6e17

Request body

multipart/form-data

Upload one image in the `image` form field.

{
  "image": "<binary image>"
}

Search images by upload

POST /api/v1/jobs/{id}/image-search

curl -X POST "https://imageextract.com/api/v1/jobs/f5ffd46b-9823-4885-89fc-db1dc80b6e17/image-search" \
  -H "Authorization: Bearer ie_live_<your-project-api-key>" \
  -F "files=@/absolute/path/to/document.pdf"

{
  "job_id": "f5ffd46b-9823-4885-89fc-db1dc80b6e17",
  "query_hashes": [
    {
      "region": "full",
      "hash": "0123456789abcdef"
    }
  ],
  "searched_images": 24,
  "hashable_images": 23,
  "matches": [
    {
      "image_id": "7d9c11448acc1470",
      "filename": "python-logo.png",
      "url": "https://www.python.org/static/img/python-logo.png",
      "distance": 2,
      "score": 96,
      "confidence": "high",
      "matched_region": "full"
    }
  ]
}

Search images by upload - API Reference

Search images by upload

Path parameters

Request body

Search images by upload

Path parameters

Request body