{
  "url": "https://telipot.com/catalog/tasks/apollo.company.enrich.bulk",
  "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": []
}