Search
curl --request POST \
--url https://api.urldna.io/v1/search \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"query": "<string>",
"max_results": 32,
"page": 1
}
'import requests
url = "https://api.urldna.io/v1/search"
payload = {
"query": "<string>",
"max_results": 32,
"page": 1
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', max_results: 32, page: 1})
};
fetch('https://api.urldna.io/v1/search', 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.urldna.io/v1/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'max_results' => 32,
'page' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.urldna.io/v1/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.urldna.io/v1/search")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.urldna.io/v1/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"submitted_url": "<string>",
"device": "DESKTOP",
"user_agent": "<string>",
"scanned_from": "<string>",
"origin": "USER",
"width": 123,
"height": 123,
"private_scan": true,
"status": "PENDING",
"submitted_date": "2023-11-07T05:31:56Z",
"domain": "<string>",
"target_url": "<string>",
"protocol": "<string>",
"http_referer": "<string>",
"nsfw": false,
"submitter_tags": [
"<string>"
],
"error_code": "<string>"
}
]{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}Endpoints
Search
Searches the scan database using query strings or CQL (Custom Query Language). Returns matching scans sorted by submission date descending. Supports complex filtering across multiple scan attributes. See documentation for CQL syntax details.
POST
/
v1
/
search
Search
curl --request POST \
--url https://api.urldna.io/v1/search \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"query": "<string>",
"max_results": 32,
"page": 1
}
'import requests
url = "https://api.urldna.io/v1/search"
payload = {
"query": "<string>",
"max_results": 32,
"page": 1
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: '<string>', max_results: 32, page: 1})
};
fetch('https://api.urldna.io/v1/search', 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.urldna.io/v1/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'max_results' => 32,
'page' => 1
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.urldna.io/v1/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.urldna.io/v1/search")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.urldna.io/v1/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"max_results\": 32,\n \"page\": 1\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"submitted_url": "<string>",
"device": "DESKTOP",
"user_agent": "<string>",
"scanned_from": "<string>",
"origin": "USER",
"width": 123,
"height": 123,
"private_scan": true,
"status": "PENDING",
"submitted_date": "2023-11-07T05:31:56Z",
"domain": "<string>",
"target_url": "<string>",
"protocol": "<string>",
"http_referer": "<string>",
"nsfw": false,
"submitter_tags": [
"<string>"
],
"error_code": "<string>"
}
]{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}{
"detail": "Error description message"
}Body
application/json
Response
Successful Response
