---
title: "POST /api/search"
method: POST
path: "/api/search"
tags: ["FaceCheckAPI"]
---

# POST /api/search

`POST /api/search`

## Request body

- SearchData
  - `id_search` string, nullable
  - `with_progress` boolean, nullable — true = return imediately with a progress. False waits until search is finished.
  - `id_captcha` string, nullable — captcha is not used
  - `status_only` boolean, nullable — true = don't submit a new search
  - `demo` boolean, nullable — true = searches only the first 100,000 faces, good for testing/debugging
  - `shady_only` boolean, nullable

## Response `200`

OK

- BrowserJsonResponse
  - `id_search` string, nullable
  - `message` string, nullable
  - `progress` integer, nullable
  - `error` string, nullable
  - `code` string, nullable
  - `output` SearchResults
    - `items` SearchItem[], nullable
      - `guid` string, nullable
      - `score` integer
      - `group` integer
      - `base64` string, nullable
      - `url` MaskedUrl
        - `value` string, nullable
      - `index` integer
      - `indexDB` integer
      - `seen` integer, nullable
    - `tookSeconds` number, double, nullable
    - `tookSecondsDownload` number, double, nullable
    - `tookSecondsQueue` number, double, nullable
    - `searchedFaces` integer, nullable
    - `freeRam` number, double, nullable
    - `demo` boolean, nullable
    - `face_per_sec` integer, nullable
    - `performance` string, nullable
    - `max_score` integer
    - `images_in_bundle` integer
    - `scaned_till_index` integer
    - `type` 0 | 1 | 2
    - `hasItems` boolean
  - `input` InputImage[], nullable
    - `base64` string, nullable
    - `id_pic` string, nullable
    - `url_source` string, nullable
    - `svg_anim` string, nullable
  - `facemon_status` string, nullable
  - `facemon_last_scann` integer, nullable
  - `was_updated` boolean
  - `hasEmptyImages` boolean
  - `new_seen_count` integer

---

[API](https://skmtc.dev/facecheck/apis/facial-recognition-reverse-image-face-search-api.md) · [All operations](https://skmtc.dev/facecheck/apis/facial-recognition-reverse-image-face-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/facecheck/facial-recognition-reverse-image-face-search-api/revisions/f7b69df082c0/schema)