Name: EnrichForge: Company and Domain Enrichment API
Brand: hybrid-forge-lab
SKU: api-hybrid-forge-lab-enrichforge
Availability: InStock
Author: API Market

# EnrichForge Company and Domain Enrichment API

## Overview

The EnrichForge API turns a domain, work email or URL into a company profile. You get the company's name, logo, social profiles, email provider, tech stack and domain age, read live from public sources.

It is built for teams that enrich sign-ups, route leads or fill in a CRM. Every response carries a `status` that says how much of the profile could be read, so there is no guessed data and no silent gaps.

## Features

*   **Company basics**: brand name, description, logo, favicon, share image and site language, read from JSON-LD and meta tags.
*   **Social profiles**: the company's own LinkedIn, X, Facebook, Instagram, YouTube, GitHub and TikTok, not share buttons or random links.
*   **Email setup**: the mailbox provider from MX (Google Workspace, Microsoft 365, Proofpoint and others), SPF senders and the DMARC policy.
*   **SaaS in use**: services the domain verified in DNS TXT records, such as Atlassian, DocuSign, HubSpot and Stripe.
*   **Tech stack**: CMS, framework, hosting or CDN, analytics, chat and payments, from HTML and header fingerprints.
*   **Domain registration**: registrar, creation and expiry dates and domain age, straight from the registry's RDAP server.
*   **Bulk lookups**: up to 25 domains, emails or URLs in one call, with results in the same order.

## Use Cases

*   **Enrich sign-ups**: turn `jane@acme.com` into a company card with name, logo, LinkedIn and stack the moment someone signs up.
*   **Route and score leads**: send Microsoft 365 or Google Workspace companies with a real domain to sales. Treat free-mail sign-ups as self-serve.
*   **Clean up the CRM**: fill in missing names, logos and socials for up to 25 domains per bulk call.
*   **Know a domain before you trust it**: domain age, DMARC policy and mail setup help you spot a week-old lookalike before it costs you.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/hybrid-forge-lab/enrichforge
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key. Keep the key on your server, because the API does not send CORS headers.

### Endpoints

#### 1. Health check

Returns `ok`, the service version and its uptime.

**Method:** `GET`

**Endpoint:** `/v1/health`

**Parameters:**

This endpoint takes no parameters.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hybrid-forge-lab/enrichforge/v1/health' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "version": "0.2.1",
  "uptime_s": 109
}
```

#### 2. Enrich one domain, work email or URL

Returns the company profile for one input. For an email address only the domain is used.

**Method:** `GET`

**Endpoint:** `/v1/enrich`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `q` | query | A domain (`stripe.com`), a work email (`jane@stripe.com`) or an http(s) URL. URL-encode it; IP addresses are rejected. | string | Yes | - | 320 characters |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hybrid-forge-lab/enrichforge/v1/enrich?q=jane@stripe.com' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK, shortened to 9 of the 11 `verified_services`):**

```json
{
  "input": "jane@stripe.com",
  "input_type": "email",
  "domain": "stripe.com",
  "status": "ok",
  "blocked_reason": null,
  "is_free_provider": false,
  "company": {
    "name": "Stripe",
    "description": "Stripe is a financial services platform that helps all types of businesses accept payments, build flexible billing models, and manage money movement.",
    "logo_url": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
    "favicon_url": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
    "image_url": "https://b.stripecdn.com/mkt-ssr-statics/assets/_next/static/media/stripe.37119086.jpg",
    "language": "en-US",
    "socials": {
      "x": "https://twitter.com/stripe",
      "youtube": "https://youtube.com/@stripe",
      "linkedin": "https://linkedin.com/company/stripe",
      "facebook": "https://facebook.com/StripeHQ",
      "github": "https://github.com/stripe",
      "instagram": "https://instagram.com/stripehq"
    },
    "contact_emails": [],
    "phones": [],
    "address": null,
    "founded": null
  },
  "website": "https://stripe.com/",
  "email": {
    "provider": "Google Workspace",
    "mx": [
      "aspmx.l.google.com",
      "alt1.aspmx.l.google.com",
      "alt2.aspmx.l.google.com",
      "aspmx2.googlemail.com",
      "aspmx3.googlemail.com"
    ],
    "accepts_mail": true,
    "spf": true,
    "dmarc_policy": "reject",
    "senders": []
  },
  "registration": {
    "registrar": "SafeNames Ltd.",
    "created_at": "1995-09-12T04:00:00Z",
    "expires_at": "2027-09-11T04:00:00Z",
    "age_days": 11371
  },
  "tech": [
    "Next.js",
    "nginx"
  ],
  "verified_services": [
    "Apple",
    "Atlassian",
    "Canva",
    "DocuSign",
    "Meta Business",
    "Google Search Console",
    "Postman",
    "Stripe",
    "Microsoft 365"
  ],
  "cached": false,
  "took_ms": 323
}
```

**Response fields:**

*   `status`: `ok`, `website_blocked`, `no_website`, `not_found` or `free_provider`.
*   `blocked_reason`: `robots_txt` or `bot_protection` when `status` is `website_blocked`, else `null`.
*   `company`: name, description, logo, favicon, share image, language, socials, contact emails, phones, address and founding date.
*   `email`: mailbox `provider`, up to 5 `mx` hosts, `accepts_mail`, `spf`, `dmarc_policy` and SPF `senders`.
*   `registration`: `registrar`, `created_at`, `expires_at` and `age_days` from RDAP. It is `null` for TLDs without RDAP.
*   `tech` and `verified_services`: detected technologies and the SaaS the domain verified in DNS TXT records.
*   `cached` and `took_ms`: whether the profile came from the 24-hour cache, and the server time spent.

What each `status` means:

*   `ok`: full profile with company, email setup, tech and registration.
*   `website_blocked`: the site exists but refused the request (bot protection or `robots.txt`). DNS and registration facts are still there.
*   `no_website`: the domain exists, with no reachable website.
*   `not_found`: the domain does not exist. This is still a 200, not an error.
*   `free_provider`: `gmail.com`, `outlook.com` and similar. `company`, `email` and `registration` are `null`.

#### 3. Enrich in bulk

Looks up up to 25 domains, emails or URLs in parallel and returns the results in input order. Each item looks exactly like a `/v1/enrich` response, or `{"input", "error"}` when that item is not a valid input, so one bad item never fails the whole call.

**Method:** `POST`

**Endpoint:** `/v1/bulk`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `items` | body | Domains, work emails or URLs to look up. | array of strings | Yes | - | 25 items |

`POST /v1/bulk` is available on the Pro, Ultra and Mega plans, not on Free.

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/hybrid-forge-lab/enrichforge/v1/bulk' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items": ["shopify.com", "jane@stripe.com", "not a domain"]}'
```

**Example Response (200 OK, shortened to 2 of the 3 results and 3 of the 10 `verified_services`):**

```json
{
  "count": 3,
  "results": [
    {
      "input": "shopify.com",
      "input_type": "domain",
      "domain": "shopify.com",
      "status": "ok",
      "blocked_reason": null,
      "is_free_provider": false,
      "company": {
        "name": "Shopify",
        "description": "Try Shopify free. Build or grow your business fast with AI. Get more than ecommerce software with tools to manage every part of your business.",
        "logo_url": "https://cdn.shopify.com/shopifycloud/brochure/assets/brand-assets/shopify-logo-primary-logo-456baa801ee66a0a435671082365958316831c9960c480451dd0330bcdae304f.svg",
        "favicon_url": "https://cdn.shopify.com/b/shopify-brochure2-assets/61cc781fe73f11e9d4bd160d27cc627b.png",
        "image_url": "https://cdn.shopify.com/b/shopify-brochure2-assets/d617483c5e5cdd01ae8b4f2571c76f34.png?originalWidth=2400&originalHeight=1260",
        "language": "en",
        "socials": {
          "facebook": "https://facebook.com/shopify",
          "x": "https://x.com/Shopify",
          "instagram": "https://instagram.com/shopify",
          "linkedin": "https://linkedin.com/company/shopify",
          "github": "https://github.com/Shopify",
          "youtube": "https://youtube.com/user/shopify",
          "tiktok": "https://tiktok.com/@shopify"
        },
        "contact_emails": [],
        "phones": [],
        "address": null,
        "founded": null
      },
      "website": "https://www.shopify.com/",
      "email": {
        "provider": "Google Workspace",
        "mx": [
          "aspmx.l.google.com",
          "alt1.aspmx.l.google.com",
          "alt2.aspmx.l.google.com",
          "alt3.aspmx.l.google.com",
          "alt4.aspmx.l.google.com"
        ],
        "accepts_mail": true,
        "spf": true,
        "dmarc_policy": "reject",
        "senders": [
          "Google Workspace",
          "Zendesk",
          "SendGrid"
        ]
      },
      "registration": {
        "registrar": "MarkMonitor Inc.",
        "created_at": "2005-03-11T05:18:03Z",
        "expires_at": "2027-03-11T05:18:03Z",
        "age_days": 7903
      },
      "tech": [
        "Shopify",
        "Cloudflare"
      ],
      "verified_services": [
        "Google Search Console",
        "Stripe",
        "Microsoft 365"
      ],
      "cached": false,
      "took_ms": 238
    },
    {
      "input": "not a domain",
      "error": "invalid domain"
    }
  ],
  "took_ms": 238
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The lookup ran. A domain that does not exist is still a 200 with `status: "not_found"`. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key has no active subscription to this API, your plan quota is used up, or the endpoint is not part of your plan (`POST /v1/bulk` on Free). |
| 404 | Not Found | The path is wrong. This API has `GET /v1/health`, `GET /v1/enrich` and `POST /v1/bulk`. |
| 422 | Unprocessable Entity | `q` is missing or is not a domain, email or http(s) URL, for example `{"detail": "invalid domain"}`. For bulk, the list is empty or has more than 25 items (`{"detail": "at most 25 items per call"}`). |
| 429 | Too Many Requests | You sent more requests per second than your plan allows. Back off and retry. |
| 500 | Internal Server Error | Something failed on the provider side. Retry once; if it keeps failing, contact us. |

## Rate Limits

Each request counts as one call, a bulk request included.

Plans:

*   **Free**: 15 lookups, a 7-day free trial, once per customer, 1 request per second. Single lookups only: `POST /v1/bulk` is not in the Free plan.
*   **Pro**: 5,000 lookups per month, 5 requests per second.
*   **Ultra**: 25,000 lookups per month, 10 requests per second.
*   **Mega**: 100,000 lookups per month, 20 requests per second.

Calls stop when the quota runs out, until the next month. Going over your plan's requests per second returns `429 Too Many Requests`, so back off and retry.

## FAQ

*   **Where does the data come from?**

    Only public sources, read live: DNS records, the registry's RDAP service and the company's own homepage. There is no scraped people database, and EnrichForge describes companies, not individuals.

*   **Why do some domains come back as `website_blocked`?**

    Some sites put bot protection in front of their homepage, or opt out in `robots.txt`. EnrichForge respects both and does not pretend to be a browser, and you still get the email setup, verified services and registration facts.

*   **Do you store what I send?**

    No. For an email address only the domain is used, the local part is never logged or kept, and company profiles are cached in memory for up to 24 hours.

*   **How fast is it?**

    About 0.7 s median for a fresh domain, since DNS, registry and homepage are read in parallel. Cached domains come back in a few milliseconds.

*   **Does it validate the email address too?**

    No, that is MailForge, our email validation API. A common pattern is to validate with MailForge first, then enrich the company with EnrichForge.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Company profile from a domain, work email or URL: name, logo, socials, email provider, tech stack and domain age, read live from public sources.

EnrichForge: Company and Domain Enrichment API

EnrichForge Company and Domain Enrichment