--- title: Bulk create URL Scans --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [URL Scanner](https://developers.cloudflare.com/api/go/resources/url_scanner) [Scans](https://developers.cloudflare.com/api/go/resources/url_scanner/subresources/scans) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # 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. ##### 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
params ScanBulkNewParams AccountID param.Field\[string] Path param: Account ID. Link to this property
Body param.Field\[\[]ScanBulkNewParamsBody]Optional Body param: List of urls to scan (up to a 100). URL string Link to this property AgentReadiness boolOptional Enable agent readiness checks. Link to this property Customagent stringOptional maxLength4096 Link to this property CustomHeaders map\[string, string]Optional Set custom headers. Link to this property Referer stringOptional maxLength4096 Link to this property
ScreenshotsResolutions \[]ScanBulkNewParamsBodyScreenshotsResolutionOptional Take multiple screenshots targeting different device types. One of the following: const ScanBulkNewParamsBodyScreenshotsResolutionDesktop ScanBulkNewParamsBodyScreenshotsResolution = "desktop" Link to this property const ScanBulkNewParamsBodyScreenshotsResolutionMobile ScanBulkNewParamsBodyScreenshotsResolution = "mobile" Link to this property const ScanBulkNewParamsBodyScreenshotsResolutionTablet ScanBulkNewParamsBodyScreenshotsResolution = "tablet" Link to this property
Link to this property
Visibility ScanBulkNewParamsBodyVisibilityOptional 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. One of the following: const ScanBulkNewParamsBodyVisibilityPublic ScanBulkNewParamsBodyVisibility = "Public" Link to this property const ScanBulkNewParamsBodyVisibilityUnlisted ScanBulkNewParamsBodyVisibility = "Unlisted" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(method)%20bulk_create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type ScanBulkNewResponse \[]ScanBulkNewResponse API string URL to api report. Link to this property Result string URL to report. Link to this property URL string Submitted URL Link to this property UUID string Scan ID. formatuuid Link to this property
Visibility ScanBulkNewResponseVisibility Submitted visibility status. One of the following: const ScanBulkNewResponseVisibilityPublic ScanBulkNewResponseVisibility = "public" Link to this property const ScanBulkNewResponseVisibilityUnlisted ScanBulkNewResponseVisibility = "unlisted" Link to this property
Link to this property
Options ScanBulkNewResponseOptionsOptional Useragent stringOptional Link to this property
Link to this property
[Link to this property](<#(resource)%20url_scanner.scans%20%3E%20(method)%20bulk_create%20%3E%20(network%20schema)>) ### Bulk create URL Scans Go HTTPTypeScriptPythonGoTerraform ``` 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) } ``` 200 example ``` [ { "api": "api", "result": "result", "url": "url", "uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "visibility": "public", "options": { "useragent": "useragent" } } ] ``` ##### Returns Examples 200 example ``` [ { "api": "api", "result": "result", "url": "url", "uuid": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "visibility": "public", "options": { "useragent": "useragent" } } ] ```