Screenshot

GEThttps://api.deepinfo.com/v1/lookup/screenshot

Opens a web page in a real browser and returns a link to a screenshot of it. Options control the viewport, full-page capture, mobile emulation, image format and how long to wait for the page.

Use it to see what a site shows right now, for example to review a suspicious or look-alike domain without visiting it yourself. A request takes a few seconds (about 5 s in our tests).

All options are query parameters; the defaults give a 1366 × 768 JPEG of the visible part of the page. To send the options as a JSON body instead (for long values such as custom_html), use Screenshot (POST).

Example

Request

curl

curl 'https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/lookup/screenshot"

params = {
    "url": "https://www.deepinfo.com"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/lookup/screenshot?url=https%3A%2F%2Fwww.deepinfo.com')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

200 OK · application/json

Response Body

{
  "url": "https://www.deepinfo.com",
  "redirected_url": "https://www.deepinfo.com/",
  "check_date": "2026-09-23T14:44:23.198Z",
  "connection_status": "success",
  "screenshot_url": "https://diss-999.storage.googleapis.com/202609/23/www-deepinfo-com-xOCDjU5LePHc6VkZeSE6-CnC.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=<credential>&X-Amz-Date=20260923T144423Z&X-Amz-Expires=604800&X-Amz-Signature=<signature>&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}

Content-Type: application/json
ratelimit-limit: 1
ratelimit-remaining: 0
ratelimit-reset: 1
deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a

Request

curl

curl 'https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/lookup/screenshot"

params = {
    "url": "not_a_url"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/lookup/screenshot?url=not_a_url')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

400 Bad Request · application/json

Response Body

{
  "code": 10400,
  "parameters": [
    {
      "param": "domain",
      "details": [
        "The given input is not a valid domain name."
      ],
      "subcode": 10000
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}

Content-Type: application/json
ratelimit-limit: 1
ratelimit-remaining: 0
ratelimit-reset: 1
deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a

Authentication

Send your API key in the apikey request header.

Query Parameters

Parameter	Required	Description
`url`	Required	Web page to capture, e.g. `https://www.deepinfo.com`. It can be left out only when `custom_html` is sent. Example`https://www.deepinfo.com`
`width`	Optional	Browser viewport width, in pixels. Range `100`–`3000`. Default `1366`. Example`1366`
`height`	Optional	Browser viewport height, in pixels. Range `100`–`3000`. Default `768`. Example`768`
`full_page`	Optional	Capture the whole page, not only the visible viewport. Default `false`. Example`false`
`mobile`	Optional	Emulate a mobile device. The viewport then defaults to 360 × 740. Default `false`. Example`false`
`landscape`	Optional	Emulate landscape orientation. Default `false`. Example`false`
`touchscreen`	Optional	Emulate a touch screen. Default `false`. Example`false`
`retina`	Optional	Render at twice the pixel density for a sharper image. Ignored when `scale` is set. Default `false`. Example`false`
`scale`	Optional	Device pixel ratio: how many screen pixels draw one CSS pixel. Range `0.5`–`4`.
`image_output`	Optional	Image format. One of `jpeg`, `png`. Default `jpeg`. Example`jpeg`
`quality`	Optional	JPEG quality. Used only when `image_output` is `jpeg`. Range `0`–`100`.
`thumbnail_width`	Optional	Resize the image to this width, keeping the aspect ratio. Must not be larger than the screenshot width. Minimum `50`.
`mode`	Optional	`fast` captures as soon as the HTML document has loaded (`domcontentloaded`); `slow` waits until network activity stops. One of `fast`, `slow`. Default `fast`. Example`fast`
`timeout`	Optional	Maximum time to wait for the page to load, in milliseconds. Range `0`–`90000`. Default `30000`. Example`30000`
`delay`	Optional	Extra wait after the page has loaded, in milliseconds, before the screenshot is taken. Maximum `30000`. Default `0`. Example`0`
`lazy_load`	Optional	Scroll through the whole page first, so that lazy-loaded images are rendered. Default `false`. Example`false`
`block_ads`	Optional	Block advertisements. Default `false`. Example`false`
`no_cookie_banners`	Optional	Hide cookie consent banners. Default `false`. Example`false`
`no_js`	Optional	Disable JavaScript on the page. Default `false`. Example`false`
`selector`	Optional	CSS selector of one element, e.g. `body > .container > .logo`. When it matches, only that element is captured.
`scroll_to_element`	Optional	CSS selector of an element to scroll to before the screenshot, e.g. `body > .footer`.
`accept_languages`	Optional	Browser `Accept-Language` value. Default `en-US`. Example`en-US`
`latitude`	Optional	Latitude reported by the browser's Geolocation API. Requires `longitude`. Range `-80`–`80`.
`longitude`	Optional	Longitude reported by the browser's Geolocation API. Requires `latitude`. Range `-180`–`180`.
`user_agent`	Optional	Browser user agent string.
`cookies`	Optional	Cookies to set in the browser, e.g. `name1=value1; name2=value2`.
`headers`	Optional	Extra request headers, e.g. `Header-1:value1; Header-2:value2`.
`css`	Optional	CSS code to inject into the page, e.g. `h1 { color: red }`.
`css_url`	Optional	URL of a stylesheet to inject into the page.
`custom_html`	Optional	HTML to render instead of loading `url`. For long HTML, use Screenshot (POST).
`proxy`	Optional	Proxy to load the page through, in the form `user:password@host:port`.

Response Fields

Field	Description
`url`	The requested URL
`redirected_url`	The URL the browser ended up on after redirects
`screenshot_url`	Link to the image (JPEG, or PNG with `image_output=png`). It is a signed link that expires after 7 days: download the image if you need to keep it
`connection_status`	`success` when the page was loaded
`check_date`	When the screenshot was taken (UTC)

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

Field	Type	Example
`url`	string	`"https://www.deepinfo.com"`
`redirected_url`	string	`"https://www.deepinfo.com/"`
`check_date`	string	`"2026-09-23T14:44:23.198Z"`
`connection_status`	string	`"success"`
`screenshot_url`	string	`"https://diss-999.storage.googleapis…"`

Errors

400 (10400) if url is missing or invalid (and no custom_html is sent), or an option is out of range. The validation error currently names the parameter domain, although the request parameter is url (see the example). 500 for an unexpected error. 503 means the service is busy or out of memory: retry shortly. See Getting Started → Errors.

Examples

Saved examples from the Deepinfo API. Selecting one loads it into the request and response panels.

Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and the response it returns.

Default ScreenshotA screenshot of www.deepinfo.com with the defaults: a 1366 × 768 JPEG of the visible part of the page.
Full-Page ScreenshotA full-page screenshot (full_page=true): the whole page from top to bottom, not only the first screen.
Mobile DeviceA mobile screenshot (mobile=true): the page on a phone-sized 360 × 740 viewport.
PNG Instead of JPEGA PNG screenshot (image_output=png): screenshot_url now ends in .png instead of .jpeg.
One Element OnlyA capture of one element (selector=h1) on example.com: only the heading, not the page.

See all examples

Reference updated September 27, 2026