{
  "url": "https://telipot.com/catalog/capabilities/company.enrich.bulk",
  "id": "company.enrich.bulk",
  "description": "Profiles of up to ten companies from their domains in one call",
  "platform": "company",
  "providers": [
    {
      "slug": "apollo",
      "name": "Apollo"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "id": "apollo.company.enrich.bulk",
      "name": "Up to 10 companies' industry, size and revenue from domains",
      "provider": {
        "slug": "apollo",
        "name": "Apollo"
      },
      "capability": "company.enrich.bulk",
      "platform": "company",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_result",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://docs.apollo.io/docs/api-pricing",
        "checked": "2026-10-05",
        "note": "1 credit per organization.",
        "state": "paid",
        "label": "$0.0196 / result",
        "amount": "$0.0196",
        "unit": "result",
        "usdPerUnit": {
          "floor": 0.0196,
          "ceiling": 0.0196
        },
        "native": {
          "text": "1 credit per result",
          "figure": "1 credit",
          "per": "result",
          "currency": "credits"
        },
        "detail": "1 credit · docs"
      },
      "providers": 1,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true,
      "summary": "Use the bulk organization enrichment endpoint to enrich data for up to ten companies with a single API call.",
      "method": "POST",
      "path": "/organizations/bulk_enrich",
      "host": "https://api.apollo.io/api/v1",
      "docsUrl": "https://docs.apollo.io/reference/bulk-organization-enrichment",
      "auth": {
        "scheme": "api_key",
        "label": "api_key · in header as x-api-key",
        "short": "api_key · x-api-key"
      },
      "scope": "any_account",
      "principal": "organization",
      "requiredScopes": [],
      "verification": {
        "state": "none",
        "label": "Not verified yet",
        "detail": "Not checked yet. We test with a real request before we mark it."
      },
      "input": [
        {
          "name": "domains[]",
          "location": "queryParams",
          "type": "array",
          "required": false,
          "constraints": [
            "at most 10"
          ],
          "note": "Domains of the companies, without www. or @; up to 10. Required unless details is sent; matches by domain only."
        },
        {
          "name": "details",
          "location": "body",
          "type": "array",
          "required": false,
          "constraints": [
            "at most 10"
          ],
          "note": "One object per company, up to 10, each with any of domain, linkedin_url, name, website. Takes precedence over domains[]; more fields improve the match."
        }
      ],
      "sampleInput": {
        "domains[]": [
          "stripe.com"
        ]
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "domains[]": {
            "type": "array",
            "description": "Domains of the companies, without www. or @; up to 10. Required unless details is sent; matches by domain only.",
            "examples": [
              [
                "stripe.com",
                "apollo.io"
              ]
            ],
            "maxItems": 10
          },
          "details": {
            "type": "array",
            "description": "One object per company, up to 10, each with any of domain, linkedin_url, name, website. Takes precedence over domains[]; more fields improve the match.",
            "examples": [
              [
                {
                  "domain": "apollo.io",
                  "name": "apollo"
                }
              ]
            ],
            "maxItems": 10
          }
        },
        "additionalProperties": false
      },
      "output": [
        {
          "name": "status",
          "type": "string"
        },
        {
          "name": "error_code",
          "type": "string | null"
        },
        {
          "name": "error_message",
          "type": "string | null"
        },
        {
          "name": "total_requested_records",
          "type": "integer | null",
          "description": "Companies submitted in details, duplicates included; null for domains[] requests."
        },
        {
          "name": "total_requested_domains",
          "type": "integer | null",
          "description": "Domains submitted in domains[], duplicates included; null for details requests."
        },
        {
          "name": "unique_domains",
          "type": "integer | null",
          "description": "Unique domains in domains[]; null for details requests."
        },
        {
          "name": "unique_records",
          "type": "integer | null",
          "description": "Unique companies in details after de-duplication; null for domains[] requests."
        },
        {
          "name": "unique_enriched_records",
          "type": "integer"
        },
        {
          "name": "missing_records",
          "type": "integer"
        },
        {
          "name": "organizations",
          "type": "object[]"
        }
      ],
      "outputSchema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "error_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "error_message": {
            "type": [
              "string",
              "null"
            ]
          },
          "total_requested_records": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Companies submitted in details, duplicates included; null for domains[] requests."
          },
          "total_requested_domains": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Domains submitted in domains[], duplicates included; null for details requests."
          },
          "unique_domains": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Unique domains in domains[]; null for details requests."
          },
          "unique_records": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Unique companies in details after de-duplication; null for domains[] requests."
          },
          "unique_enriched_records": {
            "type": "integer"
          },
          "missing_records": {
            "type": "integer"
          },
          "organizations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "website_url": {
                  "type": "string"
                },
                "linkedin_url": {
                  "type": "string"
                },
                "twitter_url": {
                  "type": "string"
                },
                "facebook_url": {
                  "type": "string"
                },
                "primary_domain": {
                  "type": "string"
                },
                "founded_year": {
                  "type": "integer"
                },
                "alexa_ranking": {
                  "type": "integer"
                },
                "logo_url": {
                  "type": "string"
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "industry": {
                  "type": "string"
                },
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "keywords": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "estimated_num_employees": {
                  "type": "integer"
                },
                "short_description": {
                  "type": "string"
                },
                "seo_description": {
                  "type": "string"
                },
                "raw_address": {
                  "type": "string"
                },
                "street_address": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "annual_revenue": {
                  "type": "integer"
                },
                "annual_revenue_printed": {
                  "type": "string"
                },
                "total_funding": {
                  "type": "integer"
                },
                "total_funding_printed": {
                  "type": "string"
                },
                "latest_funding_round_date": {
                  "type": "string"
                },
                "latest_funding_stage": {
                  "type": "string"
                },
                "funding_events": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "date": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      },
                      "investors": {
                        "type": "string"
                      },
                      "amount": {
                        "type": "string"
                      },
                      "currency": {
                        "type": "string"
                      }
                    }
                  }
                },
                "technology_names": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "current_technologies": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "uid": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "category": {
                        "type": "string"
                      }
                    }
                  }
                },
                "departmental_head_count": {
                  "type": "object"
                },
                "num_suborganizations": {
                  "type": "integer"
                },
                "organization_headcount_six_month_growth": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "organization_headcount_twelve_month_growth": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "organization_headcount_twenty_four_month_growth": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              }
            }
          }
        }
      },
      "commands": {
        "mode": "run",
        "cli": "telipot run apollo.company.enrich.bulk \\\n  --input-json '{\"domains[]\":[\"stripe.com\"]}'",
        "http": "curl https://api.telipot.com/v1/tasks/apollo.company.enrich.bulk/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"domains[]\":[\"stripe.com\"]}'",
        "quote": "telipot run apollo.company.enrich.bulk \\\n  --input-json '{\"domains[]\":[\"stripe.com\"]}' \\\n  --quote"
      },
      "siblings": []
    }
  ]
}
