Intent

Url Companies

Companies whose people visited a single URL, with a B2B/B2C split.

Aggregated from {org_id}.intent_resolved. Contact-resolved companies only - IP-only company resolution is a separate treatment and is not included here.

The response shape is field-for-field identical to the main-app POST /intent-search/url-companies that backs the FE drill-down; key parity between the two is locked by developer_api/tests/test_intent_url_companies_api.py.

Failure semantics deliberately differ from that main-app route: it swallows lookup errors and returns an empty result, which over this surface would be indistinguishable from "nobody visited". Consistent with its /intent/pages/* siblings, this raises 503 instead so a caller can tell a degraded backend from a genuine zero.

post/intent/url-companies

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/intent/url-companies
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

urlstring required

Canonical page_url (no scheme, no www)

daysinteger
limitinteger

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.