Data Enrichment

Enrich a list of company/business records with publicly observable information — website technology stack, social profiles, public contact email/phone, structured‑data location, and review/rating signals — while preserving every original field and clearly marking the fields that could not be found.

What does this Actor do?

You give it records (e.g. {"company": "Acme", "website": "https://acme.com"}). For each record it:

1. Resolves a website — from your website field, or (optionally) by looking the company up in a business directory when it has none.
2. Analyzes the website — extracting the technology/CMS stack, social profiles, public email and phone, JSON‑LD location, and aggregate rating/reviews.
3. Falls back to a business directory — filling phone, address, category and rating when a website is missing or thin.
4. Merges the results non‑destructively — original fields are never overwritten; only missing fields are filled.

Every record gets an _enrichment audit object so you can always tell "not found" apart from "not attempted".

Why use it?

• Turn a bare CRM export (just company + website) into an enriched lead list.
• Auditable by design: each record lists exactly which fields were added, which were not found, and which sources were used.
• Idempotent and safe: if you already have a value, the Actor keeps yours.

Input

Provide records in any one of these ways (resolved in priority order):

Field	Type	Description
records	array	Inline JSON array of record objects.
csv	string	CSV text with a header row.
json	string	JSON array/object as text.
datasetId	string	Enrich the items of an existing Apify dataset.
datasetUrl	string	Public URL returning a JSON array.

Enrichment options:

Field	Type	Description
enrichFrom	array	website, business_directory (default ["website"]).
websiteField	string	Record field holding the website URL (default website).
companyField	string	Record field holding the company name (default company).
proxyConfiguration	object	Proxy settings for outbound fetches.

Input example

{
  "records": [
    { "company": "Acme Corp", "website": "https://acme.com" },
    { "company": "NoWeb Plumbing" }
  ],
  "enrichFrom": ["website", "business_directory"],
  "websiteField": "website",
  "companyField": "company"
}

Output

One record per input record. All original fields are preserved. The Actor adds any of these public fields it can find (and sets the rest to null):

industry, category, technology (list), socialProfiles (map), publicEmail, publicPhone, location, rating, reviewCount.

Each record also carries an _enrichment audit object:

{
  "company": "Acme Corp",
  "website": "https://acme.com",
  "crmId": 42,
  "technology": ["WordPress", "jQuery"],
  "socialProfiles": { "facebook": "https://facebook.com/acmecorp" },
  "publicEmail": "hello@acme.com",
  "publicPhone": null,
  "location": "100 Main St, Austin, TX",
  "industry": null,
  "category": null,
  "rating": 4.5,
  "reviewCount": 88,
  "_enrichment": {
    "fieldsAdded": ["technology", "socialProfiles", "publicEmail", "location", "rating", "reviewCount"],
    "fieldsNotFound": ["industry", "category", "publicPhone"],
    "sources": ["website"]
  }
}

• fieldsAdded — enrichment fields (and any discovered website) that were newly filled.
• fieldsNotFound — fields that were attempted but not found; these are set to null.
• sources — which enrichment sources actually contributed (website, business_directory).

You can download the dataset in JSON, CSV, Excel or HTML.

Field preservation & not‑found marking

• Original keys are copied verbatim — the Actor never drops or renames your data.
• If you already supply a value for an enrichment field (e.g. rating), it is preserved; the Actor will not overwrite it, nor list it as added or not‑found.
• Fields that were attempted but could not be found are explicitly set to null and listed in fieldsNotFound.

Sources

• Website analysis — HTTPS, title/meta, technology/CMS fingerprints, social links, public email/phone, JSON‑LD Organization/LocalBusiness address and aggregateRating.
• Business directory — Bing Maps (worldwide) lookup to recover a website, phone, address, category and rating for companies with no website.

Limitations & legal

• Only publicly accessible information is processed. No authentication is bypassed and no private personal data is collected.
• Enrichment is best‑effort — always validate before acting on a field.
• Respect each source's Terms of Service, robots.txt and applicable law.