## Bulk create URL Scans

`url_scanner.scans.bulk_create(ScanBulkCreateParams**kwargs)  -> ScanBulkCreateResponse`

**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

- `account_id: str`

  Account ID.

- `body: Optional[Iterable[Body]]`

  List of urls to scan (up to a 100).

  - `url: str`

  - `customagent: Optional[str]`

  - `custom_headers: Optional[Dict[str, str]]`

    Set custom headers.

  - `referer: Optional[str]`

  - `screenshots_resolutions: Optional[List[Literal["desktop", "mobile", "tablet"]]]`

    Take multiple screenshots targeting different device types.

    - `"desktop"`

    - `"mobile"`

    - `"tablet"`

  - `visibility: Optional[Literal["Public", "Unlisted"]]`

    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.

    - `"Public"`

    - `"Unlisted"`

### Returns

- `List[ScanBulkCreateResponseItem]`

  - `api: str`

    URL to api report.

  - `result: str`

    URL to report.

  - `url: str`

    Submitted URL

  - `uuid: str`

    Scan ID.

  - `visibility: Literal["public", "unlisted"]`

    Submitted visibility status.

    - `"public"`

    - `"unlisted"`

  - `options: Optional[ScanBulkCreateResponseItemOptions]`

    - `useragent: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.url_scanner.scans.bulk_create(
    account_id="account_id",
)
print(response)
```

#### Response

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