Reveal API · IP to company

Turn an IP address into a company in one request

The Albacross Reveal API resolves any IPv4 address to the company behind it, with name, domain, size, revenue, industry and location. Build it into your product, your data pipeline or your own GTM tools.

REST · JSONIPv4Read-onlyGDPR compliant
What you get back

One request. Twelve firmographic fields.

Every match returns a structured company profile you can store, filter and act on straight away, with no scraping and no second enrichment step.

name

Registered company name

url

Company website domain

country

ISO country code of the company

address

Street, city, state and zip code

number

Company registration number

founded_year

Year the company was founded

employees

Headcount band, with from, to and range

financial_report

Revenue band and currency

nace_code

NACE industry code and category

linkedin_industry_code

LinkedIn industry code and category

linkedin_url

Company LinkedIn page

description

Short company description

What teams build with it

Company context wherever an IP shows up

Product teams, data teams and growth engineers use the Reveal API to add company intelligence to the tools they already run.

Identify visitors inside your product

Show your own users which companies visit their websites or apps, as a native feature of your platform.

Enrich signups and form fills

Add company, size and industry to every signup before it reaches your CRM, and keep your forms short.

Personalize your website

Change headlines, case studies and calls to action by industry or company size on the very first page view.

Power pipelines and AI agents

Resolve IPs in server logs, warehouses and agent workflows to give every event and every prompt company context.

How it works

Live in an afternoon, not a quarter

A single GET endpoint, clear status codes and a staging environment to build against.

1

Get your API key

Tell us your use case and expected volume. We set up a key with a quota that fits.

2

Send an IPv4 address

Call GET /company/{ip} with your key in the Authorization header.

3

Act on the response

Store the company profile, route the lead or personalize the page. No match returns a clean 204.

200Company found, profile returned as JSON
204No company matched this IP
400Invalid format or IPv6 address
401Missing or invalid API key
429Request or identification quota reached
curl https://reveal.api.albacross.com/company/203.0.113.42 \
  -H "Authorization: $ALBACROSS_API_KEY"

# 200 → company profile as JSON
# 204 → no company for this IP
async function lookupCompany(ip) {
  const res = await fetch(
    `https://reveal.api.albacross.com/company/${ip}`,
    { headers: { Authorization: process.env.ALBACROSS_API_KEY } }
  );
  if (res.status === 204) return null; // no match
  if (!res.ok) throw new Error(`Reveal API: ${res.status}`);
  return res.json(); // { name, url, employees, ... }
}
import os, requests

def lookup_company(ip):
    r = requests.get(
        f"https://reveal.api.albacross.com/company/{ip}",
        headers={"Authorization": os.environ["ALBACROSS_API_KEY"]},
        timeout=5,
    )
    if r.status_code == 204:
        return None  # no match
    r.raise_for_status()
    return r.json()
The data behind it

The same engine that powers the Albacross platform

The Reveal API runs on the same identification data behind 10,000+ B2B teams on Albacross, refined continuously as new IP ranges are mapped.

3B+Behavioral events processed every month
1.7×Higher identification rate than most intent data platforms in customer tests
12Firmographic fields per matched company
GDPRCompany-level data only, built in Stockholm for GDPR and CCPA
Choose your setup

Platform, API or both

Pick the way your team wants to work with Albacross data.

For sales, marketing & RevOps

Albacross Platform

Visitor identification, intent scoring, alerts and CRM sync in a ready-made app. No code needed.

  • Dashboards, segments and alerts
  • Two-way HubSpot, Salesforce and Pipedrive sync
  • Bombora research data
Start free trial
For developers & data teams

Reveal API

Raw IP-to-company data through one REST endpoint, for your product, warehouse or internal tools.

  • Real-time IPv4 lookups
  • 12 firmographic fields per match
  • Staging environment and Postman collection
Get an API key
For enterprise & ABM teams

Organisation plan

The full platform and API access together, with the controls larger teams need.

  • Everything in Platform, plus the API
  • Webhooks for new identified visits
  • ABM features, user roles and a dedicated success manager
Book a demo

Albacross helps us turn website visits into real account insight — a faster way to prioritize, retarget, and act on the right prospects.

10k
+
Identified Accounts
100
+
Intent Signals Scored
1
Source of Truth
Martin H. Morrissette
Demand Gen, Epidemic Sound

Albacross has enabled our marketing teams to finally see the impact their work has on sales. I think Albacross definitely was the missing link in our demand engine.

10k
+
Identified Accounts
100
+
Intent Signals Scored
1
Source of Truth
Frederic Linfjärd
Director of Growth Marketing at Planday

We’ve seen impressive results with the LinkedIn retargeting and my objective in the next phase is that I would like to continue the growth to 20,000 followers on LinkedIn and further optimize lead delivery to the sales team together with Albacross.

10k
+
Identified Accounts
100
+
Intent Signals Scored
1
Source of Truth
Robbert Linschooten
PHC Europe Marketing Specialist

The user experience with Albacross was much more simple and intuitive compared to other providers. This is something that made Albacross stand out, and was one of the defining factors in our buying decision.

10k
+
Identified Accounts
100
+
Intent Signals Scored
1
Source of Truth
Josephus Ayoola
Digital and Growth Marketing Manager
FAQs

Frequently Asked Questions

How do I get an API key?

The Reveal API is available on the Organisation plan or as a standalone data product. Tell our team your use case and expected volume and we'll set up a key with the right quota, usually within a day.

What happens when an IP can't be matched?

The API returns HTTP 204 with no body, so your code can fall back gracefully. Residential and mobile connections often don't resolve to a company.

Does the API support IPv6?

Not yet. Reveal resolves IPv4 addresses today and returns a clear 400 error for IPv6 input. IPv6 support is in development.

Are there rate limits?

Each key has a request and identification quota based on your plan. If you go over it, the API responds with HTTP 429 so you can back off and retry.

Is there a test environment?

Yes. The API docs include a separate staging environment and a ready-made Postman collection, so you can build and test before you go live.

Is the API GDPR compliant?

Yes. Reveal returns company-level firmographic data only. It identifies organisations, never individual people, and Albacross is built in Stockholm for GDPR and CCPA.