Skip to main content

API - Enrich Companies

Company Enrichment – Why It's a Two-Step Process and How to Use It

In this article, we’ll walk through how asynchronous split requests work, why Surfe uses them, and how you can work with them confidently.

 

Company Enrichment is one of the core tools available in Surfe’s API. If you're enriching company data at scale, you might wonder:

 

“Why does the enrichment happen in two steps?”

 

Let’s break it down in simple terms, no technical background needed.


Why Two Steps?

To keep things fast and scalable, Surfe’s Company Enrichment API operates asynchronously. This means:

  1. Start an Enrichment: You send a list of company domains.

  2. Check for Results: You get a unique ID to check back later for results.

Why is this helpful? When the system enriches data, it gathers information from various sources. That can take a few seconds, especially when you're enriching multiple companies. Instead of making you wait, we return an enrichmentID right away. You then check back using this ID to get your results once they’re ready.


The API Endpoints you’ll need (bulk or single, it’s the same logic):

  1. Start Company Enrichment

  2. Get Enrichment Results


Step-by-Step Guide

1. Start Your Company Enrichment Request

Send a POST request to the Start Company Enrichment endpoint.
You can include up to 500 companies per request in the companies array.

The first 2,000 company enrichments per day are covered by your free quota. Search credits are only deducted once your free quota has been exceeded. To increase the quota search credits can be purchased. 

With Search credits: Each successfully enriched company costs 1 search credit. A company counts as a successful enrichment when both annualRevenue and industry are present in the result. Credits are charged per company as enrichment completes — not at the time the request is made.

Here’s an example request (feel free to copy and use):

curl --location 'https://api.surfe.com/v2/companies/enrich' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "companies": [
      {
        "domain": "surfe.com",
        "externalID": "external-id"
      }
    ],
    "notificationOptions": {
      "webhookUrl": ""
    }
  }

Replace YOUR_API_TOKEN with your API key.

 

Example Response:

{
    "message": "Your enrichment has started ✨, estimated time: 1s.",
    "enrichmentID": "019841ef-c288-76ab-9311-41392ea079ad",
    "enrichmentCallbackURL": "https://api.surfe.com/v2/companies/enrich/019841ef-c288-76ab-9311-41392ea079ad"
}

 

This tells you that your enrichment is in progress. The enrichmentID is what you’ll use in the next step to check for your results.


2. Check for Results

We have two options to retrieve the results, manually or through webhook notifications.

 

Use the enrichmentID from the response above to get the final enriched data. You’ll do this using the Get Enrichment Results endpoint.

Example Request:

curl --location 'https://api.surfe.com/v2/companies/enrich/019841ef-c288-76ab-9311-41392ea079ad' \
--header 'Authorization: Bearer YOUR_API_TOKEN

 

While Processing:

 

If the enrichment is still in progress, you’ll see something like:

{
  "companies": [],
  "percentCompleted": 50,
  "status": "IN_PROGRESS"
}

 

You can retry the same request after a few seconds.


Once Completed:

When the enrichment is ready, the status will be COMPLETED, and you’ll receive a full breakdown of each company:

 

{
  "companies": [
    {
      "description": "Sales teams waste too much time on repetitive admin tasks. Surfe handles everything before the phone call - identifying target accounts, building lead lists, and enriching data. Our mission is to empower sales teams, automating the essential steps of the workflow while enhancing the human touch. Trusted by 3,000+ companies from local to global GTM needs like Google, Uber, AWS, Bolt, Pigment. Compatible with HubSpot, Salesforce, Pipedrive, and Copper CRM. As a GDPR-compliant and ISO27001-certified tool, Surfe helps your team operate from a gold standard of data, making sure everything is structured, categorized, updated, and protected. Surfe has been selected as Top 100 fastest-growing products on G2 and recognized as a Top 100 Rising European Startups by VivaTech in 2025.",
      "digitalPresence": [
        {
          "name": "LinkedIn",
          "url": "https://www.linkedin.com/company/surfe"
        }
      ],
      "employeeCount": 65,
      "externalID": "external-id",
      "followersCountLinkedin": 8896,
      "founded": "2020",
      "hqAddress": "52 Rue Chaussée D'antin Paris FR 75009",
      "hqCountry": "FR",
      "industry": "IT Services",
      "ipo": {
        "date": "2021-01-01",
        "sharePrice": 100,
        "sharePriceCurrency": "$"
      },
      "isPublic": false,
      "keywords": [
        "crm updates",
        "reply rate",
        "linkedin sales",
        "linkedin messages",
        "synchronize linkedin",
        "secure crm"
      ],
      "linkedInURL": "https://linkedin.com/company/surfe",
      "name": "Surfe",
      "parentOrganization": {
        "name": "Parent Organization",
        "website": "https://www.parentorganization.com"
      },
      "phones": [
        ""
      ],
      "revenue": "10-50M",
      "signals": {
        "funding": {
          "fundingRounds": [
            {
              "amount": 30000000,
              "amountCurrency": "USD",
              "announcedDate": "2026-06-12",
              "leadInvestors": [
                "Investor A",
                "Investor B"
              ],
              "name": "Series B"
            }
          ],
          "rounds": 2,
          "totalRaised": 35000000
        },
        "hiring": {
          "activePostings": 18,
          "departments": [
            {
              "activeCount": 12,
              "name": "Engineering"
            }
          ],
          "newPostingsLast30Days": 6
        },
        "leadershipChange": {
          "changeCount": 23,
          "changes": [
            {
              "date": "2026-07-01",
              "firstName": "Jane",
              "lastName": "Doe",
              "linkedinUrl": "https://www.linkedin.com/in/janedoe",
              "newCompanyDomain": "surfe.com",
              "newTitle": "VP Sales",
              "oldCompanyDomain": "starindustries.com",
              "oldTitle": "Sales Manager",
              "type": "promotion"
            }
          ]
        }
      },
      "status": "COMPLETED",
      "stocks": [
        {
          "exchange": "string",
          "ticker": "string"
        }
      ],
      "subIndustry": "Internet Services & Infrastructure",
      "websites": [
        "surfe.com"
      ]
    }
  ],
  "percentCompleted": 50,
  "status": "IN_PROGRESS"
}

You’ll now have enriched data like:

  1. Company name and description

  2. Website and LinkedIn URL

  3. Industry and sub-industry

  4. Revenue and headcount

  5. HQ address

  6. Digital presence

  7. Funding signal (rounds raised in the last 12 months) 

  8. Hiring signal (open job postings) 

  9. Leadership change signal

  10. Whether the company is publicly listed

  11. LinkedIn follower count

  12. Keywords associated with the company

Everything you need to supercharge your CRM or sales stack.

Company Signals

Enrichment results include a signals object with up to three signals:

  • signals.funding: funding rounds raised in the last 12 months. Includes rounds, totalRaised and fundingRounds (most recent first).
  • signals.hiring: open job postings. Includes activePostings, newPostingsLast30Days and open postings per department.
  • signals.leadershipChange: director-level and more senior role changes. Includes changeCount and the ten most recent changes.

Each signal is absent when Surfe holds no data for that company.

Funding rounds have moved. The top-level fundingRounds field has been removed. Read funding rounds from signals.funding.fundingRounds.

We recommend using Webhooks instead of polling for results. Check out the article here: Webhook Notifications


Summary

  • Initiate: Send your list of company domains.

  • Wait: You’ll receive an enrichmentID instantly.

  • Retrieve: Use the enrichmentID to get your enriched data when it's ready.

If you're enriching multiple companies at once, just include more entries in the companies array — up to 500 per request. Surfe handles the rest.


Need Help?

If you have any questions or need further assistance, feel free to reach out to our support team via Intercom.


Additional Resources

Was this article helpful?

0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Comments

0 comments

Please sign in to leave a comment.