Skip to content
← Retour à l’index API
GET /screenshot/thumbnail

Retrieve thumbnail image

Options

Les options sont regroupées pour faciliter la lecture, sur le modèle d’une documentation centrée sur les paramètres.

App

bottom

query integer Facultatif

Exemple : 0

Bottom crop edge in pixels

filename

query string Facultatif

Optional filename for Content-Disposition attachment

id

query integer Obligatoire

Screenshot ID

left

query integer Facultatif

Exemple : 0

Left crop edge in pixels

quality

query integer Facultatif

Exemple : 100

JPEG/WEBP quality (1-100)

ratio

query enum(fit, fill) Facultatif

Exemple : fit

Aspect ratio mode: fit (preserve) or fill (crop)

right

query integer Facultatif

Exemple : 0

Right crop edge in pixels

scale

query number Facultatif

Exemple : 1

Scale factor

shot

query integer Facultatif

Exemple : 1

Which screenshot if multiple requested

top

query integer Facultatif

Exemple : 0

Top crop edge in pixels

zoom

query integer Facultatif

Exemple : 100

Zoom percentage

Output & Format

format

query enum(png, jpeg, webp) Facultatif

Exemple : png

Image format (`webmp` alias is accepted and normalized to `webp`)

height

query integer Facultatif

Thumbnail height in pixels

width

query integer Facultatif

Thumbnail width in pixels

Réponses

200

Thumbnail image

Aucun exemple JSON fourni dans OpenAPI.

400

Invalid parameters

{
  "error": "Request validation failed",
  "code": "VALIDATION_ERROR",
  "fields": {
    "url": [
      "URL is required"
    ],
    "country": [
      "Country code must be ISO 3166-1 alpha-2"
    ]
  }
}
401

Unauthorized

{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}
404

Screenshot not found or not ready

{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}
500

Server error

{
  "success": false,
  "error": "Invalid API key",
  "code": "INVALID_API_KEY",
  "details": {
    "request_id": "req_123456"
  }
}