Surfe API
Get API KeySupportGive feedback

(Deprecated) Enrich Companies (start)

Quota limitation

This endpoint will only accept as many companies to enrich as there is company enrichment and search quota available

Starts bulk enrichment of the provided list of company domains and returns an enrichment ID.

Enrichment runs asynchronously. To be notified when the enrichments are complete, we highly recommend using the notificationOptions.webhookUrl field. This enables webhook notifications that automatically send the result to your server when ready. For more details, see the webhook documentation here.

Alternatively, you can manually check the enrichment's progress and results by sending a request to GET /v2/companies/enrich/:id. However, polling is less efficient and may introduce delays or unnecessary load.

Looking for Search V1? It’s deprecated, but still available here

POST
/v1/organizations/enrichments/bulk

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired

Companies to be enriched

domainsDeprecatedarray<string>

Deprecated: Use Organizations instead, which allows providing an external ID together with the domain

nameRequiredstring

Name for the new list that will created to store the results

organizationsarray<object>

List of organizations to enrich (maximum 500)

curl -X POST "https://api.surfe.com/v1/organizations/enrichments/bulk" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [
      "surfe.com",
      "apple.com",
      "microsoft.com"
    ],
    "name": "My list name",
    "organizations": [
      {
        "domain": "surfe.com",
        "externalID": "external-id"
      }
    ]
  }'

Enrichment ID

{
  "id": "enrichment-id"
}