Get a complete or filtered list of your public-facing websites.
Required License: Cortex Xpanse Expander
curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" -H "authorization: authorization_example" -H "x-xdr-auth-id: xXdrAuthId_example" \
"https://api-yourfqdn/public_api/v1/assets/get_external_websites" \
-d '{
"request_data" : {
"search_from" : 0,
"next_page_token" : "next_page_token",
"filters" : [ {
"field" : "host",
"value" : [ "value", "value" ],
"operator" : "contains/not_contains"
}, {
"field" : "host",
"value" : [ "value", "value" ],
"operator" : "contains/not_contains"
} ],
"sort" : {
"field" : "http_type",
"keyword" : "ASC"
},
"search_to" : 6,
"use_page_token" : true
}
}'
authorization_example
xXdrAuthId_example
{"request_data":{"filters":[{"field":"host","operator":"contains/not_contains","value":"string"}],"search_from":0,"search_to":0,"sort":{"field":"http_type","keyword":"ASC"},"use_page_token":true,"next_page_token":"string"}}
A dictionary containing the API request fields.
An empty dictionary returns all results.
String that identifies the external service field the filter is matching. Filters are based on the following case-sensitive keywords:
- host
- is_active
- technology_ids
- provider_names
- site_categories
- active_service_ids
- ips
- tags
- http_type
- third_party_script_domains
- authentication
String that identifies the comparison operator you want to use for this filter. Valid operator keywords and corresponding filter fields are:
- contains/not_contains- used with
http_type
,provider_names
,site_categories
- eq/ne - used with
host
,authentication
- in - used with
is_active
,http_type
,tags
,active_service_ids
,ips
,third_party_script_domains
,technology_ids
Value that the filter must match. The contents of this field will differ depending on the website field that you specified for this filter:
- host - string
- is_active - values are
yes
orno
- technology_ids - list of strings
- provider_names - string
- site_categories - string
- active_service_ids - list of strings
- ips - list of strings
- tags - list of strings
- http_type - values are
http_only
,http_that_redirects_to_https
,https_only
- third_party_script_domains - list of strings
- authentication - string
An integer representing the start offset index of results
Default value - 0
An integer representing the start offset index of results. Use this field to specify the number of results on a page when using page token pagination.
Default value - 500
is_active
and ASC
.Valid values are:
http_type
first_observed
last_observed
Valid values are:
- ASC - ascending order
- DESC - descending order ASC is the default.
"use_page_token":true
in the initial request to paginate the response data.
Sort is not supported when using the use_page_token
/next_page_token
fields.
"use_page_token":true
was included in the initial request, the response for that request will include a page token.
Use "next_page_token":"string"
to pass that page token into the next request to paginate the next set of data.