Leaks Overview - Osintly Documentation

GET

{id}

results

leaks

Get leaks overview

curl --request GET \
  --url https://api.osint.ly/search/{id}/results/leaks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.osint.ly/search/{id}/results/leaks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osint.ly/search/{id}/results/leaks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.osint.ly/search/{id}/results/leaks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osint.ly/search/{id}/results/leaks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "sources": [
      {
        "name": "Snusbase",
        "key": "snusbase",
        "status": "success",
        "count": 214,
        "fetch_url": "https://api.osint.ly/search/d290f1ee-6c54-4b01-90e6-d701748f0851/results/leaks/snusbase",
        "pagination": {
          "page_size": 100,
          "total_pages": 3
        },
        "logo": null,
        "description": null
      }
    ]
  },
  "meta": {
    "environment": "production",
    "timestamp": "2026-05-27T12:00:30.000Z"
  }
}

Readable sources during a search

Use fetchable and fetch_url to decide whether a source can be read. One source can be ready while another is still processing; do not wait for all providers to finish before displaying available records. With X-Osintly-Progressive-Leaks: 1, a source with an early page can have all of:

{
  "id": "snusbase",
  "key": "snusbase",
  "status": "processing",
  "count": 500,
  "fetchable": true,
  "fetch_url": "https://api.osint.ly/search/SEARCH_ID/results/leaks/snusbase",
  "pagination": { "page_size": 500, "total_pages": 1 }
}

This is an illustrative source entry inside data.sources, not a complete response. Counts and page totals are provisional until the source reaches its terminal status. Currently, early publication is supported by Snusbase. Without this header, processing sources keep count: 0, fetchable: false, fetch_url: null, and no provisional pagination. Final successful overviews have the same format with and without the header. Refresh on leak.page.ready, leak.status, and leaks.finished. Repeat the header on each overview/page request and stream reconnect.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Osintly-Progressive-Leaks

enum<string>

Set to the exact string 1 on each stream, leak-overview, and leak-page request to opt in to readable early leak pages. Omit to retain finalized-source behavior. Processing counts and pagination are provisional; final responses and authorization are unchanged.

Available options:

1

Path Parameters

string<uuid>

required

Search UUID

Response

Leaks sources overview

data

object

required

Leak sources overview.

Show child attributes

meta

object

required

Response metadata.

Show child attributes

Get leaks overview

curl --request GET \
  --url https://api.osint.ly/search/{id}/results/leaks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.osint.ly/search/{id}/results/leaks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.osint.ly/search/{id}/results/leaks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.osint.ly/search/{id}/results/leaks"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.osint.ly/search/{id}/results/leaks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "sources": [
      {
        "name": "Snusbase",
        "key": "snusbase",
        "status": "success",
        "count": 214,
        "fetch_url": "https://api.osint.ly/search/d290f1ee-6c54-4b01-90e6-d701748f0851/results/leaks/snusbase",
        "pagination": {
          "page_size": 100,
          "total_pages": 3
        },
        "logo": null,
        "description": null
      }
    ]
  },
  "meta": {
    "environment": "production",
    "timestamp": "2026-05-27T12:00:30.000Z"
  }
}

​Readable sources during a search

Authorizations

Headers

Path Parameters

Response

Readable sources during a search