SEsecurityscorecard
search

Attack Surface Intelligence API Search

post/asi/search

Request

  • Base URL
    https://api.securityscorecard.io
  • URL
    https://api.securityscorecard.io/asi/search
  • Auth
    API key in header Authorization

Request body

querystring

search query

sort'scan_date' | 'max_cvss_score' | 'min_scorecard_grade' | '_score' | 'avd_grade' | 'city' | 'cloud_provider' | 'cloud_region' | 'country_name' | 'has_cve' | 'has_cve_been_exploited' | 'has_infection' | 'has_malhash' | 'has_malrep' | 'has_ransomware' | 'has_scorecard' | 'has_screenshot' | 'has_ssl_cert' | 'has_threatactor' | 'hostname' | 'max_cvss_score' | 'min_scorecard_grade' | 'postal' | 'scan_time' | 'ssl_is_certificate_chain_valid' | 'state' | '_score' | 'has_ransomware'

values for ipv4 are:

sortDir'asc' | 'desc'

asc or desc

pagenumber

Search result page number

indexstring

Search index to query

parser'simple' | 'structured' | 'lucence' | 'dismax'

Search query parser. Options are: simple, structured, lucence, dismax

sizenumber

Size of the search resultset page

cursorstring

Cursor identifier (or "initial" for first request) needed to paginate over more than 10K results

Example request

{
  "index": "ipv4",
  "parser": "ipv4",
  "size": 10
}

Response

Search results

foundnumber

Amount of documents found

isErrorboolean

True if error, false otherwise

errorTypestring

Type of error

errorMessagestring

Error message

errorCodenumber

HTTP status code of error if error is True

cursorstring

Cursor identifier to paginate over more than 10K results

Changes

No recorded changes to this operation across all 1 revision of this API.