Scanning

Using the Scan ID received from the Submission API, you can use the Result API to poll for the scan. The most efficient approach would be to wait at least 10 seconds before starting to poll, and then only polling 2-second intervals with an eventual upper timeout in case the scan does not return.

get/api/v1/result/{scanId}/

Request

  • Base URL: https://urlscan.io
  • URL: https://urlscan.io/api/v1/result/{scanId}/
  • Auth: API key in header api-key

Path parameters

scanIdstring uuid required

UUID of scan result

Response

OK

labelsstring[]

System labels controlled by urlscan. Only in urlscan Pro

usertagsstring[]

User-defined tags applied by Saved Searches. Only in urlscan Pro

metatagsstring[]

Meta information about the scan and matched searches, e.g. the IDs of Saved Searches that this item has matched - Only in urlscan Pro (Attention: This field is called meta in the Search API)

Changes

    • breaking

      the response property ////// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the response property /////// became nullable for the status

    • breaking

      the response property ///// became nullable for the status

    • breaking

      the /// response's property type changed from object to string for status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • warning

      removed the optional property //// from the response with the status

    • info

      added the optional property / to the response with the status