コエカツ アンケート集計データ

キーワードでアンケート調査を検索します。言い換え（AI／人工知能、リモートワーク／在宅勤務など）でも見つかります。返ってくる survey_id を get_survey に渡すと集計結果を取得できます。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "探したい話題。日本語の自然な言い回しでよい（例: 老後の不安、AI活用、在宅勤務のつらいところ）"
    },
    "min_respondents": {
      "type": "integer",
      "description": "回答者数の下限。引用に耐える標本だけが欲しい場合に指定する",
      "minimum": 0
    },
    "category_id": {
      "type": "integer",
      "description": "list_categories が返した category_id。指定するとその配下（全階層）の調査だけを検索する"
    },
    "limit": {
      "type": "integer",
      "description": "取得件数（既定10、最大30）",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "query"
  ]
}

調査1件の設問・選択肢・得票数・割合を取得します。引用用の固定URL（citation.stable_url。固定できる時点が無い調査では null）とライセンスも一緒に返します。

{
  "type": "object",
  "properties": {
    "survey_id": {
      "type": "integer",
      "description": "search_surveys が返した survey_id"
    },
    "as_of": {
      "type": "string",
      "description": "YYYY-MM 形式。その月末時点までの累計に固定する（引用向け）。省略すると最新の累計",
      "pattern": "^\\d{4}-\\d{2}$"
    },
    "trusted_only": {
      "type": "boolean",
      "description": "true にすると、メール確認済みアカウントの票だけに絞った集計を返す"
    }
  },
  "required": [
    "survey_id"
  ]
}

どんな分野の調査があるかを大分類→中分類→小分類の階層で確認できます。何が調べられるか把握したいときに使います。

{
  "type": "object",
  "properties": {
    "parent_id": {
      "type": "integer",
      "description": "指定するとその配下だけを返す。省略すると大分類の一覧"
    }
  }
}