← Back to API index
GET /screenshot/search

Search screenshots by URL

Options

Options are grouped for easier scanning, similar to parameter-focused docs.

App

limit

query integer Optional

Example: 50

Maximum results

status

query enum(error, finished, processing) Optional

Example: error

Filter by status

url

query string Required

URL search pattern

Screenshot

tag

query string[] Optional

Filter by tags (comma-separated or multiple parameters)

Responses

200

Search results

▾ 
{
  "success": true,
  "data": [
    {
      "id": 12345678,
      "status": "finished",
      "url": "https://example.com",
      "final_url": "https://example.com",
      "cost": 1,
      "tag": [],
      "created_at": "2026-02-06T05:34:02.730Z",
      "finished_at": "2026-02-06T05:34:07.120Z",
      "country": "us",
      "region": "America",
      "language": "en-US",
      "timezone": "America/New_York",
      "geo_enable": false,
      "geo_latitude": 40.7128,
      "geo_longitude": -74.006,
      "size": "screen",
      "cache": 86400,
      "delay": 5,
      "screen_width": 1024,
      "screen_height": 1280,
      "priority": 2,
      "referer": "",
      "post_data": "",
      "cookie": "",
      "script": "",
      "html": false,
      "pdf": false,
      "pdf_background": false,
      "pdf_one_page": false,
      "pdf_landscape": false,
      "pdf_format": "letter",
      "pdf_margin": 0,
      "pdf_margin_top": 0,
      "pdf_margin_bottom": 0,
      "pdf_margin_left": 0,
      "pdf_margin_right": 0,
      "video": false,
      "video_format": "webm",
      "video_quality": 30,
      "video_speed": 1,
      "video_duration": 15,
      "max_wait": 0,
      "header": "",
      "hide_popups": false,
      "hide_ads": false,
      "dark": false,
      "shots": 1,
      "shot_interval": 5,
      "strict_ssl": false,
      "max_height": 0,
      "target": "",
      "device_name": "",
      "device_scale": 3,
      "device_touch": true,
      "device_landscape": false
    }
  ]
}
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"
  }
}
500

Server error

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