v1

latestOpenAPI 3.1.02026-07-247601.0 MB
Enrichment

Bulk Organization Enrichment

This endpoint consumes 1 Apollo credit per organization when an organization/company is matched or found. If Apollo doesn't find a matching organization, that organization consumes 0 credits. Learn more about API pricing and credits.

<a href="https://knowledge.apollo.io/hc/en-us/articles/33699917233293-Enrichment-Overview" target="_blank">Enrichment</a> is when you refresh existing records so your prospecting data is up-to-date.<br><br>Use the Bulk Organization Enrichment endpoint to enrich data for up to ten companies with a single API call. To enrich data for a single company, use the <a href="https://docs.apollo.io/reference/organization-enrichment">Organization Enrichment endpoint</a> instead.<br><br>You can identify the companies to enrich by providing a list of domains via the <code>domains[]</code> query parameter, or by providing a <code>details</code> array in the request body where each company can be matched by any combination of domain, LinkedIn URL, name, and website.<br><br>Enriched data potentially includes industry information, revenue, employee counts, funding round details, corporate phone numbers, locations, language counts, retail-location counts, and organization hierarchy data. The <code>owned_by_organization</code> field identifies the immediate parent, <code>owned_by_chain</code> lists parent organization IDs from the immediate parent to the ultimate parent, and <code>ultimate_parent_organization</code> identifies the topmost parent. Each result also includes <code>num_suborganizations</code> and <code>subsidiary_rollups</code> with the total estimated subsidiary employee count and distinct subsidiary countries and industries.

post/organizations/bulk_enrich

Query parameters

domains[]string[]

The domain of each company that you want to enrich. Do not include www., the @ symbol, or similar. <br><br>Use this parameter to match companies by domain only. To match by LinkedIn URL, name, or website in addition to domain, use the details array in the request body instead. <br><br>This parameter is required unless you provide a details payload in the request body. <br><br>Example: apollo.io and microsoft.com

Request body

Response

200

statusstring
{"stackTrail":"paths:/organizations/bulk_enrich:post:responses:200:content:application/json:schema:properties:error_code","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/organizations/bulk_enrich:post:responses:200:content:application/json:schema:properties:error_message","oasType":"schema","type":"unknown"}
total_requested_recordsinteger

The total number of companies submitted in the details payload, including duplicates. Returned only when you enrich using the details request body; null for domains[] requests.

total_requested_domainsinteger

The total number of domains submitted via the domains[] query parameter, including duplicates. Returned only for domains[] requests; null when you enrich using the details payload.

unique_domainsinteger

The number of unique domains submitted via the domains[] query parameter. Returned only for domains[] requests; null when you enrich using the details payload.

unique_recordsinteger

The number of unique companies submitted in the details payload after de-duplication. Returned only when you enrich using the details request body; null for domains[] requests.

unique_enriched_recordsinteger
missing_recordsinteger

Example response

{
  "status": "success",
  "total_requested_records": 4,
  "total_requested_domains": 4,
  "unique_domains": 4,
  "unique_records": 4,
  "unique_enriched_records": 4,
  "organizations": [
    {
      "id": "5e66b6381e05b4008c8331b8",
      "name": "Apollo.io",
      "website_url": "http://www.apollo.io",
      "linkedin_url": "http://www.linkedin.com/company/apolloio",
      "twitter_url": "https://twitter.com/meetapollo/",
      "facebook_url": "https://www.facebook.com/MeetApollo",
      "alexa_ranking": 3514,
      "linkedin_uid": "18511550",
      "founded_year": 2015,
      "logo_url": "https://zenprospect-production.s3.amazonaws.com/uploads/pictures/79049be00ff8e398b5935de8/picture",
      "primary_domain": "apollo.io",
      "industry": "information technology & services",
      "keywords": [
        "sales engagement"
      ],
      "estimated_num_employees": 1600,
      "industries": [
        "information technology & services"
      ],
      "snippets_loaded": true,
      "industry_tag_id": "5567cd4773696439b10b0000",
      "industry_tag_hash": {
        "information technology & services": "5567cd4773696439b10b0000"
      },
      "raw_address": "415 mission st, floor 37, san francisco, california 94105, us",
      "street_address": "415 Mission St",
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "postal_code": "94105-2301",
      "owned_by_organization": {
        "id": "parent_org_1234567890abcdef",
        "name": "Example Parent Company",
        "website_url": "https://www.example-parent.com"
      },
      "owned_by_chain": [
        "parent_org_1234567890abcdef"
      ],
      "ultimate_parent_organization": {
        "id": "ultimate_parent_abcdef123456",
        "name": "Example Holdings",
        "website_url": "https://www.example-holdings.com"
      },
      "subsidiary_rollups": {
        "countries": [
          "United States"
        ],
        "industries": [
          "information technology & services"
        ]
      },
      "seo_description": "Search, engage, and convert over 240 million contacts at over 30 million companies with Apollo's sales intelligence and engagement platform.",
      "short_description": "Apollo.io combines a buyer database of over 270M contacts and powerful sales engagement and automation tools in one, easy to use platform. Trusted by over 160,000 companies including Autodesk, Rippling, Deel, Jasper.ai, Divvy, and Heap, Apollo has more than one million users globally. By helping sales professionals find their ideal buyers and intelligently automate outreach, Apollo helps go-to-market teams sell anything.\n\nCelebrating a $100M Series D Funding Round 🦄",
      "account_id": "63f53afe4ceeca00016bdd37",
      "account": {
        "id": "63f53afe4ceeca00016bdd37",
        "domain": "apollo.io",
        "name": "Apollo",
        "team_id": "6095a710bd01d100a506d4ac",
        "organization_id": "5e66b6381e05b4008c8331b8",
        "source": "salesforce",
        "original_source": "salesforce",
        "owner_id": "60affe7d6e270a00f5db6fe4",
        "created_at": "2023-02-21T21:43:26.351Z",
        "phone": "+1(202) 555-0114",
        "phone_status": "no_status",
        "sanitized_phone": "+12025550114",
        "existence_level": "full",
        "label_ids": [
          "6504905b21ba8e00a334eb0f"
        ],
        "modality": "account",
        "source_display_name": "Imported from Salesforce"
      },
      "departmental_head_count": {
        "engineering": 228,
        "operations": 28,
        "support": 30,
        "marketing": 36,
        "human_resources": 29,
        "sales": 177,
        "finance": 8,
        "consulting": 8,
        "legal": 5,
        "arts_and_design": 27,
        "accounting": 3,
        "business_development": 14,
        "information_technology": 8,
        "education": 6,
        "media_and_commmunication": 3,
        "product_management": 16,
        "entrepreneurship": 3,
        "data_science": 6,
        "administrative": 3
      },
      "organization_headcount_six_month_growth": 12.3,
      "organization_headcount_twelve_month_growth": 24.6,
      "organization_headcount_twenty_four_month_growth": 48.9
    }
  ]
}