Search URL scans

Deprecated

GET /accounts/{account_id}/urlscanner/scan

Copy endpoint

https://api.cloudflare.com/client/v4

Search scans by date and webpages' requests, including full URL (after redirects), hostname, and path. A successful scan will appear in search results a few minutes after finishing but may take much longer if the system in under load. By default, only successfully completed scans will appear in search results, unless searching by scanId. Please take into account that older scans may be removed from the search index at an unspecified time.

Parameters

path Path Parameters

Name	Type
`account_id` required Account ID.	string

query Query Parameters

Name	Type
`scan_id` Scan UUID.	string
`limit` Limit the number of objects in the response.	number
`next_cursor` Pagination cursor to get the next set of results.	string
`date_start` Filter scans requested after date (inclusive).	string
`date_end` Filter scans requested before date (inclusive).	string
`url` Filter scans by URL of any request made by the webpage	string
`hostname` Filter scans by hostname of any request made by the webpage.	string
`path` Filter scans by url path of any request made by the webpage.	string
`ip` Filter scans by IP address (IPv4 or IPv6) of any request made by the webpage.	string
`hash` Filter scans by hash of any html/js/css request made by the webpage.	string
`page_url` Filter scans by submitted or scanned URL	string
`page_hostname` Filter scans by main page hostname (domain of effective URL).	string
`page_path` Filter scans by exact match of effective URL path (also supports suffix search).	string
`page_asn` Filter scans by main page Autonomous System Number (ASN).	string
`page_ip` Filter scans by main page IP address (IPv4 or IPv6).	string
`account_scans` Return only scans created by account.	boolean
`is_malicious` Filter scans by malicious verdict.	boolean

Responses

200 application/json

Search results

{
errors: { message: string; }[];
messages: { message: string; }[];
result: { tasks: {
country: string;
success: boolean;
time: string;
url: string;
uuid: string;
visibility: "public" | "unlisted";
}[]; };
success: boolean;
}

Client Errors

400 application/json

Invalid params.

{ errors: { message: string; }[];messages: { message: string; }[];success: boolean; }