HubSpot API で会社に紐づくすべてのプロパティ情報を取得してみた

$ HUBSPOT_ACCESS_TOKEN=[YOUR_ACCESS_TOKEN]
$ export HUBSPOT_ACCESS_TOKEN

curl -s "https://api.hubapi.com/crm/v3/objects/companies?limit=1" \
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" | jq .

{
  "results": [
    {
      "id": "26311978602",
      "properties": {
        "createdate": "2023-02-24T09:58:57.633Z",
        "domain": "example.com",
        "hs_lastmodifieddate": "2025-07-02T05:45:20.115Z",
        "hs_object_id": "26311978602",
        "name": "テストオオムラ株式会社"
      }
    }
  ]
}

curl -s "https://api.hubapi.com/crm/v3/properties/companies" \
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" \
  | jq -r '.results[] | "表示名: \(.label)\nプロパティ名: \(.name)\n---"'

表示名: 業界
プロパティ名: industry
---
表示名: 年間売上
プロパティ名: annualrevenue
---

curl -s "https://api.hubapi.com/crm/v3/objects/companies?limit=1&properties=name,industry,annualrevenue" \
  -H "Authorization: Bearer $HUBSPOT_ACCESS_TOKEN" | jq .

{
  "results": [
    {
      "id": "26311978602",
      "properties": {
+       "annualrevenue": null,
        "createdate": "2023-02-24T09:58:57.633Z",
        "hs_lastmodifieddate": "2025-07-25T08:21:53.053Z",
        "hs_object_id": "26311978602",
+       "industry": "IT・ビジネスコンサルティング",
        "name": "テストオオムラ株式会社"
      },
      "createdAt": "2023-02-24T09:58:57.633Z",
      "updatedAt": "2025-07-25T08:21:53.053Z",
      "archived": false
    }
  ],
  "paging": {
    "next": {
      "after": "26311978603",
      "link": "https://api.hubapi.com/crm/v3/objects/companies?limit=1&properties=name%2Cindustry%2Cannualrevenue&after=26311978603"
    }
  }
}

#!/bin/bash

# HubSpot全会社の全プロパティを取得するスクリプト
# 使用方法: ./get_company_all_properties.sh [limit]

# 設定
TOKEN="${HUBSPOT_ACCESS_TOKEN}"
LIMIT="${1:-10}"  # デフォルトは10件

# トークンの存在チェック
if [ -z "$TOKEN" ]; then
  echo "エラー: HUBSPOT_ACCESS_TOKEN環境変数が設定されていません"
  echo "使用方法: export HUBSPOT_ACCESS_TOKEN=your_token_here"
  exit 1
fi

# 全プロパティ名を取得
echo "=== 利用可能なプロパティ一覧を取得中 ==="
PROPS=$(curl -s "https://api.hubapi.com/crm/v3/properties/companies" \
  -H "Authorization: Bearer $TOKEN" \
  | jq -r '.results[].name' \
  | tr '\n' ',' \
  | sed 's/,$//')

if [ -z "$PROPS" ]; then
  echo "エラー: プロパティの取得に失敗しました"
  exit 1
fi

echo "取得したプロパティ数: $(echo $PROPS | tr ',' '\n' | wc -l)"

# 全会社の全プロパティを取得（ページネーション対応）
echo "=== 全会社の全プロパティ情報を取得中（最大${LIMIT}件） ==="

AFTER=""
TOTAL_COUNT=0
ALL_RESULTS="[]"

while [ $TOTAL_COUNT -lt $LIMIT ]; do
  REMAINING=$((LIMIT - TOTAL_COUNT))
  BATCH_LIMIT=$((REMAINING > 100 ? 100 : REMAINING))

  if [ -n "$AFTER" ]; then
    URL="https://api.hubapi.com/crm/v3/objects/companies?limit=$BATCH_LIMIT&properties=$PROPS&after=$AFTER"
  else
    URL="https://api.hubapi.com/crm/v3/objects/companies?limit=$BATCH_LIMIT&properties=$PROPS"
  fi

  RESPONSE=$(curl -s "$URL" -H "Authorization: Bearer $TOKEN")

  # レスポンスをチェック
  if [ $? -ne 0 ] || [ -z "$RESPONSE" ]; then
    echo "エラー: API呼び出しに失敗しました"
    break
  fi

  # 結果を追加
  RESULTS=$(echo "$RESPONSE" | jq '.results // []')
  ALL_RESULTS=$(echo "$ALL_RESULTS" | jq ". + $RESULTS")

  # 取得件数を更新
  BATCH_COUNT=$(echo "$RESULTS" | jq 'length')
  TOTAL_COUNT=$((TOTAL_COUNT + BATCH_COUNT))

  echo "取得済み: ${TOTAL_COUNT}件"

  # 次のページがあるかチェック
  AFTER=$(echo "$RESPONSE" | jq -r '.paging.next.after // empty')
  if [ -z "$AFTER" ] || [ $BATCH_COUNT -eq 0 ]; then
    break
  fi
done

echo "=== 取得完了: 総件数 ${TOTAL_COUNT}件 ==="

# 最終結果を出力
echo "$ALL_RESULTS" | jq .