IP to Company API - Identify Companies and Firmographics

Turn a list of IP addresses into company records. For each address you get the company name and marketing alias, website, industry and sub-industry, NAICS and SIC codes, employee count and size band, annual sales and revenue band, full address, phone, LinkedIn profile, corporate hierarchy and audience segment. You pay only for the records you actually receive.

This actor is built for visitor identification, enriching web and server logs, de-anonymising traffic in analytics exports, routing and scoring inbound leads, and any workflow that starts with an address and needs to know which company is behind it.

What you can do with it

• Identify the companies behind a list of website visitor IP addresses.
• Enrich a server or CDN log export with firmographics before it reaches your warehouse.
• Score and route inbound demo requests by company size, revenue and industry.
• Separate real corporate traffic from ISP and consumer traffic.
• Map identified accounts to their parent and ultimate parent company.
• Export everything as JSON, CSV or Excel, or push it into your CRM or warehouse.

Features

• Bulk lookups: paste hundreds of addresses, one per line, and get one row each.
• IPv4 and IPv6 accepted; invalid entries and duplicates are removed before any request is made.
• Match-level aware: a Detailed result carries the full company profile, a Basic result carries registry data only.
• An optional filter to keep only addresses that matched a real company, so you are not charged for registry-only rows.
• Corporate hierarchy on every record: parent and ultimate parent company IDs and names.
• Audience and audience segment classification, plus an ISP flag and access type.
• Account Connector custom fields passed straight through when your account has them configured.
• Optional page, page title and referrer context sent with each lookup so the calls report correctly on the provider side.
• Addresses that are not in the index are logged and skipped instead of ending the run.
• Pay-per-result pricing with a hard result cap so a run can never surprise you.

Input

Field	Type	Description
ipAddresses	array	Addresses to identify, one per line. Required.
onlyMatchedCompanies	boolean	Skip and do not charge for registry-only results.
pageUrl / pageTitle / referrer	string	Optional context sent with each lookup.
maxResults	integer	Stop after this many records (1 to 5,000).
apiKey	string	Your server-side API token. Required, stored securely.

Example output

Each dataset item is one address. Fields are populated where the provider has data, and the complete provider payload is kept under raw:

{
  "ip": "203.0.113.24",
  "informationLevel": "Detailed",
  "companyId": 645072,
  "companyName": "Acme Robotics, Inc.",
  "marketingAlias": "Acme Robotics",
  "website": "acmerobotics.com",
  "industry": "Computer Software",
  "subIndustry": "Industrial Automation Software",
  "primaryNaics": "513210",
  "primarySic": "7371",
  "employeeCount": 750,
  "employeeRange": "Mid-Market",
  "annualSales": 235000000,
  "revenueRange": "$100M - $250M",
  "companyType": "Private",
  "companyStatus": "Operating",
  "businessStructure": "Global Parent",
  "streetAddress": "500 Congress Avenue",
  "city": "Austin",
  "state": "TX",
  "zip": "78701",
  "country": "US",
  "countryName": "United States",
  "phone": "+1 512 555 0100",
  "companyLinkedinProfile": "https://www.linkedin.com/company/acme-robotics",
  "audience": "Mid-Market Business",
  "audienceSegment": "Software & Technology",
  "accessType": "corporate",
  "isIsp": false,
  "registryCompanyName": "LEVEL3",
  "registryCity": "Austin",
  "registryCountryCode": "US",
  "raw": { "company_name": "Acme Robotics, Inc." }
}

An address with no company match returns informationLevel: "Basic" and only the registry fields, which is the provider's way of saying the address resolved to an ISP or an unallocated block.

Pricing and the credit model

This actor uses pay-per-result pricing. You are charged a fixed price for each record delivered to the dataset, and nothing for a run that returns none. Turn on onlyMatchedCompanies if you only want to pay for addresses that resolved to a real company. Set maxResults to cap how many records a run can collect, and set a run spending limit as a second safety net.

Bring your own API key

This actor connects to a third-party company identification provider (Demandbase) on your behalf and requires your own provider API token. The token must be a server-side token that is permitted to pass the query parameter, which is what a lookup by address uses; a client-side tag token will not work for bulk lookups. Paste it into the apiKey input. It is stored securely and never logged, and the actor never ships with or shares credentials.

Frequently asked questions

What data does this actor return?

For a matched address: company ID, name and marketing alias, website, industry and sub-industry, primary NAICS and SIC codes, employee count and size band, annual sales and revenue band, company type, status, ownership and business structure, stock ticker, full postal address and phone, LinkedIn company profile, audience and audience segment, access type, and parent and ultimate parent company. For an unmatched address: registry-level data such as the registered network owner, city, country and coordinates.

What is the difference between Detailed and Basic?

Detailed means the address resolved to a known company, so the full profile is returned. Basic means no company matched and only registry data is available. The informationLevel field on every row tells you which you got, and onlyMatchedCompanies filters out the Basic ones.

How do I get an API token?

The API is part of a paid subscription. Your provider account team issues a server-side API token, typically 32 to 48 alphanumeric characters. Ask specifically for a token that is allowed to bypass the query parameter restriction, otherwise server-side lookups by address will be rejected.

Why do the returned attributes vary between rows?

The provider states plainly that the attribute set is not fixed: properties may be added or removed at any time and may be null when data is unavailable. This actor is written defensively for that. It surfaces the recommended attributes as stable columns when present, and always keeps the untouched provider payload under raw, so nothing is lost when the provider adds a field.

Does it cache results?

No. The provider asks integrators not to cache responses, because cached calls never reach it and that skews the analytics on their side. Every address in your list produces a live lookup.

What happens to invalid or duplicate addresses?

They are removed before any request is made, so you are never charged for them. Addresses the provider does not have are logged as not found and skipped.

How am I charged?

You pay a fixed price per record returned to the dataset. A run that returns nothing costs nothing. Use onlyMatchedCompanies, maxResults and the run spending limit to control cost.

What output formats are available?

The dataset can be exported as JSON, CSV, Excel, HTML or RSS, or read through the API for pushing into a CRM or warehouse.

Keyword map

ip to company, ip address lookup api, visitor identification, company identification api, reverse ip lookup, firmographic enrichment, website visitor identification, anonymous traffic de-anonymisation, b2b visitor tracking, log enrichment, account identification, ip firmographics, company data by ip, abm visitor identification, lead routing data, revenue range data, employee range data, corporate hierarchy data, audience segment data, ip intelligence api.