Company

A Company object describes a company that visited your website at least once in the requested period. For example, Bergquell Mineralbrunnen GmbH reads your pricing page several times, and GET /company returns its address, its size, its NACE codes, and its activity.

The object holds data about the company, not visits and not people. Visits are in the Session object, contacts in the Contact object. The data model shows how the objects fit together.

RulesCopy Anchor Link

• One entry per company: GET /company returns every company that had at least one visit on the requested website between from_date and to_date. The order of the entries is not fixed.
• Missing values: When Webmetic doesn't know a value, the field is missing. It isn't sent as null. The exception is fit_score, which is null without an ideal customer profile. The feeds, by contrast, return unknown values as null, as described under Missing fields and null.
• ID: company_id stays the same for a company. If you keep companies in your CRM for the long term, store company_url as a second key.
• Scores ignore the period: The requested period doesn't change the scores. Activity counts all of the company's visits on this website.
• Freshness: Webmetic refreshes name, address, and industry codes on later visits. It recalculates the scores on every visit and also at regular intervals.
• Several websites: GET /company accepts domain more than once, for example ?domain=a.de&domain=b.de. Each company then appears only once, with the scores of the first listed website it visited.
• Exclusions: Webmetic records no new visits for companies whose domain is on the domain blacklist and for organization types you switch off under Menu > Organization types. Earlier visits stay in the API. Your own company is missing from the data of your own website.
• Cost: Reading company data costs no credits and works on every plan, including Free.

FieldsCopy Anchor Link

The table lists the fields of the object.

Webmetic writes the texts in short_description_*, full_description_*, what_they_do_*, how_they_make_money_*, and target_audience_* from the company's website.

New fields can appear at any time. Your code should therefore ignore unknown fields.

RangesCopy Anchor Link

employee_count and revenue are ranges of two numbers [min, max], not exact numbers. When Webmetic doesn't know the size, the field is missing.

• Employees: [1, 10], [11, 50], [51, 200], [201, 500], [501, 1000], [1001, 5000], [5001, 10000], and [10001, null] with no upper limit.
• Revenue: ranges in euros from [0, 100000] to [100000000, 500000000], and [500000000, null] with no upper limit.

ScoresCopy Anchor Link

The three scores run from 0 to 100. The dashboard shows them under other names:

When the last visit lies further back, activity falls even without a new visit.

fit_score is null as long as the website has no ideal customer profile. Then relevance_score equals lead_score.

In the example below, a fit_score of 92 and a lead_score of 88 give a relevance of 80.96. For how Webmetic calculates the values, see Relevance, activity, and fit.

NACE codesCopy Anchor Link

nace_codes holds one to three classes of the European industry classification NACE Rev. 2.1 (2025 edition). Webmetic assigns the codes from the company's website.

The first class is the main activity. There's no separate field for this, because the order carries it. When a company has no code, nace_codes is missing.

Each entry has ten fields:

wz2025_codes has the same structure for the German classification WZ 2025, with codes like "11.07.0". Webmetic adds all WZ subclasses of the chosen NACE classes, so a company can have many.

The order of the WZ entries doesn't mark a main activity. In WZ entries, section_description_de is in capitals, for example "VERARBEITENDES GEWERBE".

GET /company_nace returns the NACE codes as a flat table: one row per code with company_id and the ten fields. Because the rows have no company_name, you get the name from /company through company_id.

Companies without a NACE code have no row. The endpoint takes a single domain, and pagination counts NACE rows there, not companies.

Fields per endpointCopy Anchor Link

/company-sessions returns the Company object with visits embedded: sessions[] holds your account's sessions in the period, described under Session. Each session holds its page views in user_data[], described under Page View.

The three feeds /intensive-visits, /returning-visits, and /new-visits also put fields of the earliest session, sessions_total, and pages_total at the top level. Visit types describes which companies the feeds return.

ExampleCopy Anchor Link

The example shows one entry from result of GET /company, with shortened texts:

{
  "company_id": "41ea486a9c95",
  "company_name": "Bergquell Mineralbrunnen GmbH",
  "company_url": "www.bergquell.example",
  "company_logo_url": "https://logos.docs.example/bergquell.png",
  "organization_type": "business",
  "address": "Brunnenweg 4",
  "postal_code": "85354",
  "city": "Freising",
  "country": "Deutschland",
  "country_code": "DE",
  "directors": ["Florian Obermaier"],
  "phone_number": "+49 89 99998214",
  "email_address": "info@bergquell.example",
  "employee_count": [201, 500],
  "revenue": [50000000, 100000000],
  "vat_id": "DE000000000",
  "registration_number": "HRB 000000",
  "registration_court": "Amtsgericht München",
  "primary_color": "#1f6feb",
  "lead_score": 88.0,
  "fit_score": 92,
  "relevance_score": 80.96,
  "linkedin": "https://www.linkedin.com/company/bergquell-mineralbrunnen-example",
  "short_description_de": "Mineralbrunnen mit eigener Abfüllung für Mineralwasser und Erfrischungsgetränke.",
  "short_description_en": "Mineral spring with its own bottling of mineral water and soft drinks.",
  "nace_codes": [
    {
      "code": "11.07",
      "full_code": "C 11.07",
      "section_code": "C",
      "section_description_de": "Verarbeitendes Gewerbe/Herstellung von Waren",
      "section_description_en": "Manufacturing",
      "division_code": "C11",
      "division_description_de": "Getränkeherstellung",
      "division_description_en": "Manufacture of beverages",
      "description_de": "Herstellung von Erfrischungsgetränken und Mineralwässern",
      "description_en": "Manufacture of soft drinks and bottled waters"
    }
  ]
}

The example has no fax_number, tax_number, or secondary_color, because Webmetic doesn't know these values for Bergquell. The example also leaves out the long texts and wz2025_codes.

Edge casesCopy Anchor Link

Missing fields and nullCopy Anchor Link

The three feeds return every one of their fields, with null for unknown values and [] for empty lists.

In webhooks, a field can also be null when Webmetic truncated the delivery. Then data.truncated is true, as described under Webhooks. So always handle both cases in your code: the field is missing, and the field is null.

Hidden companies on the Free planCopy Anchor Link

On the Free plan, you see only some of the companies. The API returns the others as hidden entries with company_id, a placeholder name in company_name ("Verborgenes Unternehmen", German for "hidden company"), and "blurred": true.

• /company: All other fields are missing.
• /company-sessions: The sessions of a hidden company hold only session_id and timestamp.
• Feeds: Every field except company_id, company_name, and blurred is null. sessions stays a list, and each session keeps all its fields. Only session_id and timestamp have a value, the other fields are null, and user_data is empty.
• /company_nace and webhooks: Hidden companies are left out entirely.
• Contacts: /contacts/search, /contacts/lookup, and /contacts/find answer 403 with PLAN_REQUIRED for hidden companies.

Visible companies have no blurred field. Filter out hidden entries by blurred before you process the data. Which companies you see is described under Plans.

Domain not in your accountCopy Anchor Link

When the requested domain doesn't belong to your account, the API answers 403 with API_KEY_NOT_AUTHORIZED. This also applies to a variant with www.. Enter the domain exactly as the dashboard shows it. For details, see Errors.

No lookup of a single companyCopy Anchor Link

There's no endpoint that returns a single company by company_id. The API also doesn't filter by industry, size, or score. Fetch the period and filter in your own system.

Used byCopy Anchor Link

• Endpoints: GET /company returns one Company object per company, GET /company-sessions the object with sessions and page views, and GET /company_nace the NACE codes as one row per code.
• Feeds: GET /intensive-visits, GET /returning-visits, and GET /new-visits return a fixed set of fields with sessions.
• Sessions: GET /session names company_id and company_name per session.
• Contacts: POST /contacts/search, POST /contacts/find, and GET /contacts/lookup take company_id. For a company without a visit on your websites, they answer 403 with COMPANY_NOT_IDENTIFIED, as described under Contact.
• Webhooks: company.identified, company.returned, company.intensive_visit, and segment.entered carry the company in data.company, as the sample event shows. For details, see Webhooks.
• AI assistant: The AI assistant also retrieves companies, with the tools list_visiting_companies and get_company_profile.