--- title: Search URL scans --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [URL Scanner](https://developers.cloudflare.com/api/python/resources/url_scanner) [Scans](https://developers.cloudflare.com/api/python/resources/url_scanner/subresources/scans) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Search URL scans url\_scanner.scans.list(ScanListParams\*\*kwargs) -> [ScanListResponse]() GET/accounts/{account\_id}/urlscanner/v2/search Use a subset of ElasticSearch Query syntax to filter scans. Some example queries: \- ‘path:“/bundles/jquery.js”’: Searches for scans who requested resources with the given path. \- ‘page.asn:AS24940 AND hash:xxx’: Websites hosted in AS24940 where a resource with the given hash was downloaded. \- ‘page.domain:microsoft\* AND verdicts.malicious:true AND NOT page.domain:microsoft.com’: malicious scans whose hostname starts with “microsoft”. \- ‘apikey:me AND date:\[2025-01 TO 2025-02]’: my scans from 2025 January to 2025 February. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `URL Scanner Write``URL Scanner Read` ##### ParametersExpand Collapse account\_id: str Account ID. [Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) q: Optional\[str] Filter scans [Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20q%20%3E%20(schema)>) size: Optional\[int] Limit the number of objects in the response. [Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20size%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class ScanListResponse: …
results: List\[Result] \_id: str Link to this property
page: ResultPage asn: str Link to this property country: str Link to this property ip: str Link to this property url: str Link to this property
Link to this property result: str Link to this property
stats: ResultStats data\_length: float Link to this property requests: float Link to this property uniq\_countries: float Link to this property uniq\_ips: float Link to this property
Link to this property
task: ResultTask time: str Link to this property url: str Link to this property uuid: str Link to this property visibility: str Link to this property
Link to this property
verdicts: ResultVerdicts malicious: bool Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(model)%20scan_list_response%20%3E%20(schema)>) ### Search URL scans Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) scans = client.url_scanner.scans.list( account_id="account_id", ) print(scans.results) ``` 200 example ``` { "results": [ { "_id": "9626f773-9ffb-4cfb-89d3-30b120fc8011", "page": { "asn": "AS15133", "country": "US", "ip": "93.184.215.14", "url": "https://example.com" }, "result": "https://radar.clouflare.com/scan/9626f773-9ffb-4cfb-89d3-30b120fc8011", "stats": { "dataLength": 2512, "requests": 2, "uniqCountries": 1, "uniqIPs": 1 }, "task": { "time": "2024-09-30T23:54:02.881Z", "url": "https://example.com", "uuid": "9626f773-9ffb-4cfb-89d3-30b120fc8011", "visibility": "public" }, "verdicts": { "malicious": true } } ] } ``` ##### Returns Examples 200 example ``` { "results": [ { "_id": "9626f773-9ffb-4cfb-89d3-30b120fc8011", "page": { "asn": "AS15133", "country": "US", "ip": "93.184.215.14", "url": "https://example.com" }, "result": "https://radar.clouflare.com/scan/9626f773-9ffb-4cfb-89d3-30b120fc8011", "stats": { "dataLength": 2512, "requests": 2, "uniqCountries": 1, "uniqIPs": 1 }, "task": { "time": "2024-09-30T23:54:02.881Z", "url": "https://example.com", "uuid": "9626f773-9ffb-4cfb-89d3-30b120fc8011", "visibility": "public" }, "verdicts": { "malicious": true } } ] } ```