Skip to main content
Question

How to identify which HTTP URI matched the query in Platform API results

  • October 28, 2025
  • 4 replies
  • 51 views

Hello,

Since the transition to the Censys Platform, it appears that multiple HTTP URIs can now be returned for a single IP and port.
However, the API response alone doesn’t seem to indicate which HTTP URI actually matched the query condition.

Although the "matched_services" field includes the port number that matched the query, it’s unclear which specific URI within that port satisfied the query.

Here’s an example for reference:

I’m using the following API endpoint and query with the Censys Platform API:

  • API endpoint: https://api.platform.censys.io/v3/global/search/query

  • Query: host.services.endpoints.http.body:"xxx" (using a specific keyword in practice)

In the API response, the "matched_services" field shows the port number that matched the query.

However, within the port listed in "matched_services", multiple HTTP URIs (for example: "/", "/login", "/robots.txt", etc.) can appear, and it seems that the API response does not indicate which specific HTTP URI actually matched the query condition.

In this case, although several HTTP URIs were returned for the same port, only the response for the root path "/" matched the query.

Is there any way to determine which HTTP URI matched the query from the API response?
If not, are there any recommended workarounds or best practices to identify the matched URI?

Thank you!

4 replies

MattK_Censys
Forum|alt.badge.img+2
  • Censys Community Manager
  • November 1, 2025

Hey Kurumi, this is not currently possible within the Platform. We’ve created some tasks internally to address this need; thank you for raising it.


  • Author
  • Frequent Contributor
  • November 5, 2025

Thanks for the update and for creating internal tasks to address this!
When the improvement is implemented, could you please share an update here?
I’d like to let the customer who requested this feature know once it’s available.

If updates won’t be posted here, could you let me know where I can check for progress or release notes?

Thank you!


MattK_Censys
Forum|alt.badge.img+2
  • Censys Community Manager
  • November 5, 2025

Hey Kurumi, we’ll include a mention of it in the release notes when the improvement goes out. Thanks!


  • Author
  • Frequent Contributor
  • November 6, 2025

Thanks! I’ll check the release notes.

Looking forward to the update!