Your Reveal API and Enrich API keys are on the API Keys page in Settings. Each API has its own keys: a private key and, if you need one, a public key.
Open the API Keys page
Open the profile menu at the bottom left and click Settings.
Click API Keys under App Configuration. Or go straight to app.albacross.com/account/api.
The Overview tab has a Reveal API panel and an Enrich API panel. The Usage tab has your usage by month.
Only the Owner and Admins see this page, plus custom roles with the Reveal API permission. Members and Viewers don't. On Starter and Professional, the page is part of your plan. If you don't see API Keys in Settings, ask the Owner or an Admin of your account, or contact us via the chat. See Access levels: Owner, Admin, Member, Viewer and custom roles.
Request your keys
Outside a free trial, keys aren't created automatically. Until we set them up, a panel shows Reveal API keys have not been generated yet or Enrich API keys have not been generated yet.
During a free trial, your Reveal API keys are created for you, with a small monthly limit. The public key's allowlist starts empty, so it doesn't work on any website until you ask us via the chat to add yours. The private key works straight away.
Click Request API Keys in the panel of the API you want. This opens the chat.
Tell us what you want to build and, if you'll use the Reveal script or the public key, which websites it will run on, and roughly how many lookups a month you expect.
We create the keys and set your monthly limits. They then show in the panel. It can take a few minutes after that before the API accepts a new key.
Public key and private key
Public Key: for code that runs in the visitor's browser, like the Reveal script. It only works on the websites on its allowlist. We keep the allowlist for you: tell us via the chat which websites to add or remove, including any subdomains it should work on, like
shop.example.com.Private Key: for your server only. Anyone who has it can use it from anywhere and use up your monthly limit. Never put it in website code, a browser extension or a public repository.
Both keys are partly hidden by default: you see only the start and the last four characters. Click the eye icon in the field to show the full key, and Copy to copy it.
Use the keys
For the Reveal script: under the Reveal API keys, Reveal Script has the script with your public key already filled in. Copy it and add it to every page where you want to identify the company. It's separate from the Albacross tracking script, which you still need if you want companies in your Website Visitors list.
For calls from your server: the key you copy already starts with Api-Key, for example Api-Key sk_…. That's the whole value of the Authorization header. Where the developer docs show Authorization: Api-Key YOUR_API_KEY, replace Api-Key YOUR_API_KEY with the copied key. Adding Api-Key again makes every call fail.
For endpoints, code examples and guides, see docs.albacross.com, or click Documentation & Guides at the top of the API Keys page.
Replace a key or change the allowlist
You can't create, replace or delete keys yourself in the app. If a private key may have leaked, or you want a new key for any other reason, contact us via the chat or support@albacross.com and say which API and which key. We replace it, and the old key stops working. Update your website and code with the new key straight away.
The same goes for adding or removing websites on the public key's allowlist.
If calls are refused
401 (Reveal API only): the request had no key. Check that the
Authorizationheader is sent.403: the key wasn't accepted. Usually
Api-Keywas added twice, the key was copied incompletely or has been replaced, or the public key was used on a website that isn't on its allowlist.429: you've reached a monthly limit. See How do Reveal API and Enrich API limits work?
For what each API does, see What are the Reveal API and the Enrich API?


