## Search URL scans

`client.URLScanner.Scans.List(ctx, params) (*ScanListResponse, error)`

**get** `/accounts/{account_id}/urlscanner/v2/search`

Use a subset of ElasticSearch Query syntax to filter scans. Some example queries:<br/> <br/>- 'path:"/bundles/jquery.js"': Searches for scans who requested resources with the given path.<br/>- 'page.asn:AS24940 AND hash:xxx': Websites hosted in AS24940 where a resource with the given hash was downloaded.<br/>- 'page.domain:microsoft* AND verdicts.malicious:true AND NOT page.domain:microsoft.com': malicious scans whose hostname starts with "microsoft".<br/>- 'apikey:me AND date:[2025-01 TO 2025-02]': my scans from 2025 January to 2025 February.

### Parameters

- `params ScanListParams`

  - `AccountID param.Field[string]`

    Path param: Account ID.

  - `Q param.Field[string]`

    Query param: Filter scans

  - `Size param.Field[int64]`

    Query param: Limit the number of objects in the response.

### Returns

- `type ScanListResponse struct{…}`

  - `Results []ScanListResponseResult`

    - `ID string`

    - `Page ScanListResponseResultsPage`

      - `ASN string`

      - `Country string`

      - `IP string`

      - `URL string`

    - `Result string`

    - `Stats ScanListResponseResultsStats`

      - `DataLength float64`

      - `Requests float64`

      - `UniqCountries float64`

      - `UniqIPs float64`

    - `Task ScanListResponseResultsTask`

      - `Time string`

      - `URL string`

      - `UUID string`

      - `Visibility string`

    - `Verdicts ScanListResponseResultsVerdicts`

      - `Malicious bool`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/url_scanner"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  scans, err := client.URLScanner.Scans.List(context.TODO(), url_scanner.ScanListParams{
    AccountID: cloudflare.F("account_id"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", scans.Results)
}
```

#### Response

```json
{
  "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.881000+00:00",
        "url": "https://example.com",
        "uuid": "9626f773-9ffb-4cfb-89d3-30b120fc8011",
        "visibility": "public"
      },
      "verdicts": {
        "malicious": true
      }
    }
  ]
}
```