POST /v1/company-reveal.
Coming soon: a website pixel that identifies visiting companies automatically,
without building your own IP capture. It is following in the coming weeks.
How it works
- Your backend captures the visitor’s IP address, for example from your web server or analytics pipeline.
- It sends the IP to
POST /v1/company-revealwith your API key. - The response contains the matched companies (if any) and the IP’s approximate location.
Pricing
You are charged only when a lookup finds at least one company: one charge per lookup, however many companies it returns. No-match lookups and every error response are free. Each response shows the charge inusage.total_usd.
Lookups use the same balance as your radars (see Balance System).
We suppress company results for selected IPv4 hosting ranges where attribution
is unreliable. Suppressed lookups aren’t charged.
Best practices
- Store results. Every request is a new lookup, so the same IP is charged again. Keep each IP’s result on your side instead of looking it up on every page view.
- Send only public IPs. Filter out internal, VPN and health-check traffic first.
- Treat a match as a strong signal, not proof of who the visitor was. Shared networks (mobile carriers, VPNs, cloud providers) can also skew the location in
ip_geo.