# snapwonders-com Analyse API

**Canonical:** https://apis.io/apis/snapwonders-com/snapwonders-com-analyse-api/  
**Provider:** snapwonders-com — https://apis.io/providers/snapwonders-com/  
**Base URL:** https://snapwonders.com  
**Documentation:** https://snapwonders.com/api

snapwonders-com Analyse API is one of 8 APIs that [snapwonders-com](https://apis.io/providers/snapwonders-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Analyse. The published artifact set on APIs.io includes an OpenAPI specification.

**Analyse images and videos for forensic integrity.** Detects faces, text regions, watermarks, and manipulation artefacts. Returns a per-file forensic grade (A–F) with detailed counts. All endpoints require `X-Api-Key`. **Workflow — 6 steps:** **Step 1 — Create a session** `POST /api/analyse/session` Returns `upload_uid` — include it in every upload for this session. **Step 2 — Upload files to analyse** `POST /api/upload` · headers `X-Upload-Uid`, `X-Filename`, `Content-Type`, file as the body. One request per file. Large files or unreliable connections: TUS `POST /api/tus` with `Upload-Metadata: upload_uid <b64(uid)>,step MQ==` instead. **Step 3 — Verify all uploads are complete** `GET /api/analyse/session/{uid}/files` All files must show `"status":"completed"` before proceeding. **Step 4 — Start the analysis job** `POST /api/analyse/job` · Required: `upload_uid` Optional: `face_detection`, `text_detection`, `face_sensitivity`, `expiry` Watermark detection and forensic analysis are always enabled. Returns `{"status":"queued", "job_uid": "..."}`. **Step 5 — Poll until done** `GET /api/analyse/job/{uid}` — repeat every few seconds. Watch `status`: `queued` → `processing` → `completed` (or `partial` / `failed`). **Step 6 — Read results** `GET /api/analyse/job/{uid}/results` Returns `result_items` with per-file `overall_grade` (A–F), `face_count`, `text_region_count`, and `watermark_flagged`. Also returns `result_html_url` (browser result page) and `result_json_url` (machine-readable JSON result). **Step 6b — Fetch results as JSON (optional)** `GET /api/analyse/result/{job_uid}` Returns the same result data as clean JSON — file names, grades, and detection counts only. No internal fields.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/analyse/session` | Create a media analyse session |
| GET | `/api/analyse/session/{uid}/files` | List uploaded files for an analyse session |
| POST | `/api/analyse/job` | Start a media analysis job |
| GET | `/api/analyse/job/{uid}` | Get analyse job status |
| GET | `/api/analyse/job/{uid}/results` | Get analyse job results |
| GET | `/api/analyse/result/{jobUid}` | Get analyse results as clean JSON |
| GET | `/api/analyse/asset/{assetId}` | Download an analysis image asset |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/snapwonders-com/openapi/snapwonders-com-analyse-api-openapi.yml
- **APIsJSON** — https://artifacts.apis.io/snapwonders-com/apis.yml

## Other snapwonders-com APIs (7)

- [snapwonders-com Convert API](https://apis.io/apis/snapwonders-com/snapwonders-com-convert-api/)
- [snapwonders-com Hide API](https://apis.io/apis/snapwonders-com/snapwonders-com-hide-api/)
- [snapwonders-com MCP API](https://apis.io/apis/snapwonders-com/snapwonders-com-mcp-api/)
- [snapwonders-com Media Upload - Direct API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-direct-api/)
- [snapwonders-com Media Upload - TUS Resumable API](https://apis.io/apis/snapwonders-com/snapwonders-com-media-upload-tus-resumable-api/)
- [snapwonders-com Reveal API](https://apis.io/apis/snapwonders-com/snapwonders-com-reveal-api/)
- [snapwonders-com Status API](https://apis.io/apis/snapwonders-com/snapwonders-com-status-api/)

## Tags

Analyse

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/snapwonders-com/snapwonders-com-analyse-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/snapwonders-com/.