Report Builder

The Report Builder lets you quickly aggregate data from your search results. It helps you identify values of interest and statistical outliers, supporting deeper investigation and analysis. To limit the results to only the services or endpoints that match your query, check the Filter my results to display services or endpoints that match my query box.

This guide walks you through the steps to generate a report using the Censys Platform.

Generate a report

  1. Go to https://platform.censys.io.

  2. Enter the required query, and click Search.

    Censys returns all matching results.

    📘

    Note

    You can also create reports from the filter sidebar.

  3. Click the Report Builder tab in the navigation bar.

  4. Click Select Breakdown. To find the field you want to use, type its name and select it from the dropdown.

    1. For example: host.services.port.
  5. Use the Results dropdown to select how many buckets of aggregated values you want in your report.

    1. Decide whether to filter the report aggregations based on your query by checking the Filter my results to display services or endpoints that match my query box.

    Filtering examples

    Example 1
    If your query is host.services.protocol=SSH, and you break down the report by host.services.port:

    • Unchecked box: Your report will include all ports used by any protocol on hosts that matched your SSH query.
    • Checked box: Your report will only include SSH-specific ports, those that match the protocol in your original query.

    Example 2
    If your query is web.endpoints: (http.status_code >= "200" and http.status_code <= "204"), and you break down the report by web.endpoints.http.status_code:

    • Unchecked box: The report may include status codes outside the 200 to 204 range, because other endpoints on the same web properties could return different codes.
    • Checked box: Only status codes within the 200 to 204 range will be included.
  6. Click Generate Report.
    The output will appear in a table format.

  7. To export the report, click JSON to download it.