Search from a shared article or page URL
Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns 503, never an empty result. For direct URL-to-record identity resolution use the entities get operation (GET /v1/entities/detail?url=...) instead.
Authentication
X-Client-Secretstring
Client secret for read-only service-to-service access (no writes)
Query parameters
url
Public article or page URL to search from
page
Zero-based page index (0..N)
size
The size of the page to be returned
sort
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.
Response
OK
query
Search query synthesized from the page content.
url
The fetched page URL after validation.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error