Skip to main content
GET
Company Enrichment

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

id
string

Deterministic DataDingo company ID

Maximum string length: 100
domain
string

Domain name (e.g. 'smec.com'). Resolves the bare registrable, a TLD-sibling, or any known alias.

Required string length: 1 - 255
website
string

Company website URL

Required string length: 1 - 2048
linkedin_slug
string

LinkedIn organisation vanity slug (the path segment after /company/, e.g. 'westpac'). Case-insensitive.

Required string length: 1 - 200
linkedin_url
string

LinkedIn organisation page URL (e.g. 'https://www.linkedin.com/company/westpac/'). /company/, /showcase/ and /school/ paths and any regional subdomain are accepted; the slug is extracted and looked up.

Required string length: 1 - 2048
linkedin_id
string

LinkedIn's stable numeric organisation id (the linkedin.id served on a record). Survives slug renames.

Pattern: ^[0-9]{1,20}$
tz
string

IANA timezone (e.g. Australia/Sydney, the default) used to render signals.news.last_published_at as a calendar day and to interpret news_published_after as local midnight. Unknown zones are rejected with 400.

Maximum string length: 64

Response

Full company profile with enrichment data

Full company profile with enrichment data

id
string
required

Deterministic DataDingo company ID (ADR-0014) — one record per website, derived by hashing the host that owns it. Stable across rebuilds for as long as that host is the same; domain is the human-readable label for the same thing.

name
string
required

Display name — the LinkedIn organisation's name for host-first records, falling back to the record host.

The legal entity operating this website, as Australian registers describe it. Null when — and only when — no ABN is attached to the record: the website is the record, the entity is an attribute of it. match.confidence says how much to trust the link.

website
string | null
required

Primary company website: https:// plus the site's host, with no path (e.g. https://www.example.com.au). When the site redirects to another domain, that destination is used only if it carries the same brand name; otherwise the original host is served.

domain
string | null
required

Canonical primary domain — bare registrable for single-tenant brands, the host for multi-tenant ones.

description
string | null
required

How the company describes itself. Its LinkedIn About text when it has one, otherwise the best paragraph its own website offers (an about page, the schema.org description, the social preview text). When the LinkedIn About is only LinkedIn's generic auto-generated line ("X is a … company based out of

."), the website's text is preferred and that line is served only when the website offers nothing usable. Always text from the company's LinkedIn page or its own website, never our summary of the company. See signals.sources.description (admin) for which one.

tagline
string | null
required

The company's short self-description or slogan — the one-line strapline from its LinkedIn page, else its website's schema.org slogan. Null when it publishes none (a page title is never used).

logo
string | null
required

Company logo image URL — the LinkedIn page logo, else the website's schema.org logo, its social preview image, its declared apple-touch-icon, or its declared favicon (the site's own <link rel="icon">, which may be a small 16–32px image). Null when none of these is published. See signals.sources.logo (admin) for which one was used.

linkedin
object | null
required

The LinkedIn organisation this record is identified by (ADR-0014: LinkedIn is the identity source; the ABN is an attribute), the two counts its page publishes, the ownership type it declares there, and the two lists of other pages it shows (affiliated, similar). Null when the record has no LinkedIn link.

year_founded
integer | null
required

The year the company says it was founded — self-declared on its LinkedIn page, else stated on its own website. This is the business's own story of its origin, which is often EARLIER than the year its current legal entity was registered; for that, use legal_entity.year_registered. Null when the company states no founding year.

hq_location
string | null
required

Headquarters city/suburb as a single string (e.g. 'Sydney'). Null when no locality is known — never a state code in its place, and never taken from the ABN's registered address. When the only address known is a LinkedIn office that publishes only a postcode, this is that postcode's representative suburb — one locality chosen per postcode, which may not be the suburb the office is actually in (postcode 2170 always reads 'Liverpool'). Not an object: the head-office state is the first entry of states (and on its office in locations[]) and is what the hq_state search filter reads; use locations[] for the full office list.

hq_country
string | null
required

Head-office country as its English name (e.g. 'Australia', 'United States'), or null when unknown. Taken from the company's LinkedIn page when it names a country; otherwise 'Australia' when the company is listed as Australian-headquartered or its head-office address is Australian.

web_status
string | null
required

What the last visit to the website found: 'live' (fetched successfully within ~180 days), 'stale' (fetched successfully, but longer ago than that), 'unverified' (never visited), 'blocked' (the site answered and refused us — a firewall, login wall or rate limit; the site is up), 'empty' (the visit succeeded but there was no site — a parking or for-sale lander, a suspended-hosting placeholder, a 404/410, or a page with no readable content), or 'unreachable' (the visit failed outright — DNS, connection, TLS or timeout). Independent of legal_entity.abn_status, which is company liveness. Null only on a record built before this field existed.

web_last_verified_at
string | null
required

ISO 8601 timestamp of the last time the website was successfully reached. A failed re-check does not move it. Null if the site has never been fetched successfully.

locations
object[]
required

The company's Australian offices, primary first. Taken from the office list on its LinkedIn page when it publishes one (an office's state is read from its postcode when the page names no region); otherwise a single entry built from the headquarters fields, so a company we know a location for is never served an empty list. When the page lists offices but none is in the head office's state, the head office is appended LAST as a non-primary entry, so the state the hq_state filter matches is always on the card. At most 10 offices: the primary office and the next ones in LinkedIn's order (when the cut would drop every office in the head office's state, the first such office takes the last place) — locations_total says how many there are, and the state and locality search filters match every office, including those past the cut. Empty when we know no Australian location at all.

states
string[]
required

Every Australian state or territory the company has an office in, head office first — exactly what the state search filter matches (including offices past the ten locations[] serves). One entry for most companies; [] when no office state is known.

locations_total
integer
required

How many Australian offices the company has on record. Larger than the length of locations when the list was cut; 0 when locations is empty.

employee_range
required

Employee-size band: the 'Company size' bucket the company publishes on its LinkedIn page — one of '1', '2-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+', LinkedIn's nine bands, the vocabulary B2B tools share. It is the company's own, approximate figure: measured against register staff counts it holds the real headcount about 2 times in 3 and is within about one band nearly 9 times in 10, so say "about" and treat a neighbouring band as plausible. Null means the company publishes no size bucket we could read — not that it is small. Government register headcounts are never used here: they count the legal entity behind the ABN, which for a brand site, franchise or group often is not the organisation the website belongs to.

Available options:
1
employee_range_source
string | null
required

Where employee_range came from. 'linkedin-banded' = the 'Company size' bucket the company itself publishes on its LinkedIn page — today the only source. Null in exactly the case employee_range is null.

specialties
string[]
required

The capability keywords the company lists on its own LinkedIn page (e.g. 'Cloud Migration', 'Payroll'). Self-declared marketing language, not a classification — for the taxonomy view use industry. At most 10, the first ones in the company's own order — specialties_total says how many it lists, and search (q) and lookup_by_name match every one of them, including those past the cut. Empty array when it lists none.

specialties_total
integer
required

How many specialties the company's LinkedIn page lists. Larger than the length of specialties when the list was cut; 0 when it lists none.

phones
object[]
required

Phone numbers the company publishes on its own site, most-likely-switchboard first and capped. Each entry carries the page it came from.

emails
object[]
required

Email addresses the company publishes on its own site, general mailbox first and capped. Off-domain mailboxes are dropped whenever an on-domain one exists.

social_media
object
required

Social media profile URLs

industry
object
required

Industry codes across three taxonomies (LinkedIn V2, NAICS, ANZSIC), each with provenance (source) and a confidence. linkedin is the company's LinkedIn industry; naics is looked up forwards from it (never the reverse), so it is null when there is no LinkedIn industry. anzsic is a separate judgement read directly from the company's website or LinkedIn page, so it can disagree with linkedin and naics, and can be present when they are null (or the reverse). confidence on linkedin/naics is a trust tier; on anzsic it is a measured share of right answers. linkedin.alternatives carries the classifier's runner-up guesses. The entity's own registry identifiers (ABN, ACN) live in the legal_entity block.

signals
object
required