## Bulk create URL Scans

`client.URLScanner.Scans.BulkNew(ctx, params) (*[]ScanBulkNewResponse, error)`

**post** `/accounts/{account_id}/urlscanner/v2/bulk`

Submit URLs to scan. Check limits at https://developers.cloudflare.com/security-center/investigate/scan-limits/ and take into account scans submitted in bulk have lower priority and may take longer to finish.

### Parameters

- `params ScanBulkNewParams`

  - `AccountID param.Field[string]`

    Path param: Account ID.

  - `Body param.Field[[]ScanBulkNewParamsBody]`

    Body param: List of urls to scan (up to a 100).

    - `URL string`

    - `Customagent string`

    - `CustomHeaders map[string, string]`

      Set custom headers.

    - `Referer string`

    - `ScreenshotsResolutions []ScanBulkNewParamsBodyScreenshotsResolution`

      Take multiple screenshots targeting different device types.

      - `const ScanBulkNewParamsBodyScreenshotsResolutionDesktop ScanBulkNewParamsBodyScreenshotsResolution = "desktop"`

      - `const ScanBulkNewParamsBodyScreenshotsResolutionMobile ScanBulkNewParamsBodyScreenshotsResolution = "mobile"`

      - `const ScanBulkNewParamsBodyScreenshotsResolutionTablet ScanBulkNewParamsBodyScreenshotsResolution = "tablet"`

    - `Visibility ScanBulkNewParamsBodyVisibility`

      The option `Public` means it will be included in listings like recent scans and search results. `Unlisted` means it will not be included in the aforementioned listings, users will need to have the scan's ID to access it. A a scan will be automatically marked as unlisted if it fails, if it contains potential PII or other sensitive material.

      - `const ScanBulkNewParamsBodyVisibilityPublic ScanBulkNewParamsBodyVisibility = "Public"`

      - `const ScanBulkNewParamsBodyVisibilityUnlisted ScanBulkNewParamsBodyVisibility = "Unlisted"`

### Returns

- `type ScanBulkNewResponse []ScanBulkNewResponse`

  - `API string`

    URL to api report.

  - `Result string`

    URL to report.

  - `URL string`

    Submitted URL

  - `UUID string`

    Scan ID.

  - `Visibility ScanBulkNewResponseVisibility`

    Submitted visibility status.

    - `const ScanBulkNewResponseVisibilityPublic ScanBulkNewResponseVisibility = "public"`

    - `const ScanBulkNewResponseVisibilityUnlisted ScanBulkNewResponseVisibility = "unlisted"`

  - `Options ScanBulkNewResponseOptions`

    - `Useragent string`

### 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"),
  )
  response, err := client.URLScanner.Scans.BulkNew(context.TODO(), url_scanner.ScanBulkNewParams{
    AccountID: cloudflare.F("account_id"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}
```

#### Response

```json
[
  {
    "api": "api",
    "result": "result",
    "url": "url",
    "uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "visibility": "public",
    "options": {
      "useragent": "useragent"
    }
  }
]
```