Retrieve summary for a list of IoCs

🚧

IoC scanning and dataset inclusion

Any IoC submitted or queried via the API will be scanned and added to the Google Threat Intelligence dataset, making it accessible to the community. Do not submit or query indicators containing sensitive, confidential, or personally identifiable information (PII).

Retrieve summary for a list of IoCs.The request body should contain a list of IoC descriptors.

Input

Accepts a list of up to 1,000 IoC descriptors in a single POST request.

Supported IoC Types

File hashes (MD5, SHA1, SHA256), domains, URLs, and IP addresses.

Output

Returns a concise summary object for each requested IoC, intended to improve efficiency and performance for large-scale enrichments.

Large Payloads

If the response exceeds the 30MB size limit, the API provides a GCS fallback mechanism, returning an HTTP 302 Found redirect to a short-lived (15 minutes TTL) signed URL for downloading the full JSON result.

Error Handling

Batch requests follow an "all-or-nothing" approach; if any single IoC cannot be processed, the entire request will be rejected with a 400 Bad Request.

Example

POST /api/v3/iocs/summary
    Content-Type: application/json
    x-apikey: <YOUR_API_KEY>
   
    {
      "iocs": [
        {
          "type": "file",
          "id": "44d88612fea8a8f36de82e1278abb02f"
        },
        {
          "type": "domain",
          "id": "example.com"
        },
        {
          "type": "ip_address",
          "id": "8.8.8.8"
        }
      ]
    }