Skip to content

Organizations

An Organization is “an outside party as one startup knows it, keyed by its domain”: count the ones that fit, then list them best first.

Calls
4
Emits
Organization.counted, Organization.found, Organization.enriched, Organization.resolved

A Data Verb reads the market and returns a reading. A Software Verb changes your records and emits an Event. Every call here is a Data Verb: it reads, and it changes a record only where its Effects say so.

Properties

Field Type What null means
count number, in companies Never null: a count of 0 means no company matched.
ignored string[] Never null: empty when every filter you sent was applied.
observedAt string, in ISO 8601 Never null.
method Observed['method'] Never null. Counts read 'estimated': they come from a company index, not a live read of each site.
organizations Organization[] Never null: empty when nothing matched, at $0.
organizations[].hostname Hostname Never null: a company is keyed by its domain.
organizations[].name string Never null.
organizations[].industry string | null Unknown: no source classifies it.
organizations[].headcount number | null, in people Unknown, never zero.
organizations[].country string | null, in ISO 3166-1 Unknown.
organizations[].region string | null, in ISO 3166-2 Unknown.
organizations[].fit { score: number; verdict: 'strong' | 'possible' | 'no' | 'unknown' }, in score 0 to 1 Absent without question. unknown means no quote on the site could be confirmed word for word.
organizations[].evidence { quote: string; url: string }[] Absent without question. Every quote appears verbatim on the page it cites.
organizations[].similarity { score: number; reason: string } Absent without similarTo.
organizations[].event { kind: string; date: string; summary: string; url: string } Absent without where.event.
organizations[].place { address: string; phone: string | null; rating: number | null; reviews: number | null } Absent without where.near.
organizations[] Observed Each row also carries observedAt and method, and venue and locale where the reading has them.
after Cursor The last page: there are no more rows.
total number | null, in companies The source does not report a total.
cost Cost, in USD Never null. In try mode usd is 0 and maxUsd is what the call would have cost.
organizations[].description string | null Unknown.
organizations[].headcountTrend { months: 6 | 12 | 24; change: number }[], in share, 0.21 is +21% Absent without headcount in fields.
organizations[].founded number | null, in year Unknown.
organizations[].socials { linkedin?: string; x?: string; facebook?: string } Never null: a missing key means no profile was found on that site.
organizations[].technologies { name: string; category: string; firstSeen: string | null; evidence: 'page' | 'job-post' | 'dns' | null }[] Absent without technologies. firstSeen: null means seen, date unknown.
organizations[].hiring { title: string; postedAt: string; url: string; location: string | null }[] Absent without hiring; empty means no open role in since.
organizations[].events { kind: string; date: string; summary: string; url: string }[] Absent without events; empty means nothing dated in since. A funded event carries the round.
organizations[].filled string[] Never null: the fields this call filled, so a miss is visible.
organization Organization | null No company matched the clue: a residential or mobile IP, a free-mail address, or an unknown name. Free.
organization.confidence number, in score 0 to 1 Never null when organization is set.
matchedOn 'ip' | 'email' | 'name' | 'hostname' Never null: the clue that matched.
created boolean Never null: true only when save created the Organization.

Object

JSON
{
  "name": "Harborview Property Management",
  "hostname": "harborview-pm.com",
  "industry": "Real estate",
  "headcount": 34,
  "founded": 2009,
  "country": "US",
  "region": "US-WA",
  "doors": 1100
}

Verbs

VerbThe question it answersPriceSuccess rate
Organization.countHow many companies match my customer?Free100% of 171,792 calls
Organization.findWhich companies fit my customer, best first?3.8¢ per 100 rows100% of 185,187 calls
Organization.enrichWhat is this company, what does it run, and what happened there lately?20¢ per 100 companies99.98% of 569,418 calls
Organization.resolveWhich company is behind this visit, address or name?Free99.97% of 419,320 calls

The order you call them in

  1. Organization.count: How many companies match my customer?
  2. Organization.find: Which companies fit my customer, best first?
  3. Organization.enrich: What is this company, what does it run, and what happened there lately?
  4. Organization.resolve: Which company is behind this visit, address or name?

Monitors on this Noun

VerbWhat it watches
Organization.enrichA saved company raises, hires for a role your product replaces, or adds a product to its site.
Organization.findNew companies in your filters that raised or posted a role this week.

Works with

Contents