2026年、新しいAIツールに登録しようとすると、ほぼ必ず同じ3文字に出くわします。API です。ChatGPT、画像生成ツール、ウェブスクレイパー、CRM連携——どこを見ても顔を出すのに、解説記事の大半はあいかわらず手垢のついたレストランのたとえから入り、肝心の「APIが実際にどう見えるのか」までは踏み込みません。本記事は、その物足りなさを埋めにいきます。読み進めれば、本物のAPIリクエストとレスポンスを目にしながら、営業チームやオペレーションの業務フロー、EC基盤が、なぜ毎日APIに支えられているのかが腑に落ちるはずです。
Thunderbit では、コードを書かないビジネスチームに技術的な概念をどう噛み砕いて伝えるかを、長らく考え続けてきました。そこで実際にAPIを叩き、調べ直し、多くの解説が省いてしまう「見せるだけ・説明するだけで終わらない」体験をこの1本にまとめました。営業担当、マーケティングマネージャー、EC運営担当——実務で本当に効いてくる部分を、ここでまとめて押さえてしまいましょう。
APIとは？ わかりやすい定義
API（Application Programming Interface）とは、あるソフトウェアが別のソフトウェアにデータや処理を頼み、決まった形式で答えを受け取るためのルールの集まりです。
別の言い方をすれば、2つのシステムをつなぐ公式の窓口です。データベース全体やアプリ全体、その奥にある会社のすべてにアクセスできるわけではありません。APIが公開している範囲に、APIが想定する形式でアクセスし、約束された分だけ受け取ります。IBM、MuleSoft、Postman のいずれも、APIをソフトウェア同士が決められたルールとプロトコルで通信するための仕組み、いわば契約だと説明しています。
ドライブスルーの窓口を思い浮かべると掴みやすいでしょう。決まった形式で注文を伝え、メニューやサイズ、必要ならカスタマイズも含めて欲しいものを受け取ります。厨房に立ち入る必要はありません。メニューがAPIドキュメント、窓口がエンドポイント、レシートがレスポンスにあたります。
とはいえ、たとえ話で語れるのはここまでです。実際のAPI呼び出しがどんな見た目なのか、覗いてみましょう。
実際のAPIリクエストとレスポンスの例
いますぐ、このURLをブラウザのアドレスバーに貼り付けてみてください。
https://api.agify.io?name=michael
これで Agify API に GETリクエスト を送り、「michael」という名前から推定される年齢を尋ねたことになります。返ってくるのは、こんなJSONレスポンスです。
{
"count": 304886,
"name": "michael",
"age": 61
}
| レスポンスの一部 | 意味 |
|---|---|
| "name": "michael" | 入力した値。つまり、あなたが尋ねた名前 |
| "age": 61 | APIがデータに基づいて予測した年齢 |
| "count": 304886 | 予測に使われたデータ数 |
これだけです。API呼び出しは終わりました。コードもターミナルもインストールもいりません。リクエストはパラメータ付きのURLで、レスポンスはブラウザにテキストとして並んだ構造化データでした。どんなAPIも原理は同じで、構造化したリクエストを送り、構造化したレスポンスを受け取ります。
APIではないもの
APIはデータベースそのものではありません。データベース（あるいはサービスやモデル）の手前に置かれた、アクセスを制御する層です。
APIはウェブサイトでもありません。ウェブサイトは人が読み、クリックするために作られています。APIはソフトウェアが読み取って処理するためのもので、見た目のあるページではなく構造化データ（たいていはJSON）を返します。
APIはハッキングでもありません。提供元が意図して公開したデータと操作だけを扱います。
ビジネスチームがAPIを気にするべき理由
営業、オペレーション、マーケティング、ECのどこにいても、自分でAPIリクエストを打つ機会はないかもしれません。それでも、APIにつながったソフトウェアには毎日頼り切っています。APIの考え方を押さえておけば、ツールの選定、自動化の設計、開発チームとのやり取りで、はっきりと差がつきます。
APIは、すでに日々の仕事のあちこちに埋め込まれています。たとえば、こんな場面です。
| 日常の行動 | 裏側で動くAPI |
|---|---|
| WebサイトでGoogleアカウントでログインする | OAuth 2.0 / ID API |
| 購入画面で最新の配送料を見る | 配送業者の料金API（UPS、FedExなど） |
| Webサイトから見込み客情報をスプレッドシートに取り込む | ウェブ抽出API（例：Thunderbit） |
| オンラインでクレジットカード決済を受け付ける | Stripe、PayPal、または別の決済API |
| 店舗検索ページに地図を埋め込む | Google Maps API |
| CRMとメールツールを同期する | 連携API（Zapier、Make、またはネイティブコネクタ） |
| サポートページでAIチャットボットを使う | LLM または NLP API |
結果として、手入力が減り、ミスが減り、数時間かかっていた作業が数秒で片づくようになります。Postmanの2025年 State of the API レポート によれば、回答者の 37% がいまやAPIから直接収益を上げており、前年の28%から伸びています。さらに 66% が自社を「APIファースト」と答えていて、アプリを作る前にAPIを設計・検証していることを意味します。
次にSaaSツールを評価するときは、ひとつだけ問いを立ててみてください。APIはあるか、そして何を公開しているか。これだけで、連携まわりの頭痛を何か月ぶんも減らせるかもしれません。
APIはどう動く？ リクエスト・レスポンスの流れを解説
基本の流れは、いつも変わりません。
- あなた（クライアント） がリクエストを送ります——「ニューヨークの天気を教えて」。
- API がそれを受け取り、有効か、権限があるかを確かめ、ふさわしいサーバーへ振り分けます。
- サーバー がリクエストを処理します——データベースを照会する、モデルを動かす、何らかの計算をする、といった具合です。
- API がレスポンスを返します——答えを含む構造化データ（たいていはJSON）と、何が起きたかを示すステータスコードです。
ひとつの流れにまとめると、こうなります。
クライアント → リクエストを送信（メソッド + エンドポイント + ヘッダー + 本文）→ APIエンドポイント → サーバー が処理 → APIエンドポイント → レスポンスを送信（ステータスコード + JSON本文）→ クライアント
実際によく使う重要用語
| 用語 | やさしい意味 |
|---|---|
| エンドポイント | リクエストを送る特定のURL（建物の特定の窓口のようなもの） |
| HTTPメソッド | GET（データを読む）、POST（データを送る）、PUT（データを更新する）、DELETE（データを削除する） |
| リクエストヘッダー | リクエストに付ける追加情報（身分証のようなもの。認証トークンやコンテンツタイプなど） |
| レスポンスボディ | 実際に返ってくるデータ（通常はJSON形式） |
| ステータスコード | APIからの短い返事。200（成功）、401（認証なし）、404（未検出）、429（リクエスト過多）、500（サーバーエラー） |
出典: MDN HTTP overview、MDN HTTP request methods、MDN HTTP response status codes。
あいまいなリクエストは、そのまま弾かれます。正しいエンドポイント、メソッド、権限、フィールドを備えたリクエストだけが通ります。よくできたAPIドキュメントは、「何を、どう頼めるのか」を教えてくれる取扱説明書のような存在です。
API vs. SDK vs. Webhook vs. Library: 何が違う？
ベンダーの提案資料では、「API」「SDK」「webhook」「library」がまるで同義語のように並んでいることがあります。けれど、実際は別物です。私自身、何度もそうした説明に出くわしてきたので、この混乱がいかに根深いかは身に染みています。昔の自分に手渡してあげたかった整理表が、これです。
| 概念 | 何か | わかりやすい例え | 例 |
|---|---|---|---|
| API | 2つのプログラムが会話するためのルールの集合 | ドライブスルー窓口 | OpenAI API、Google Maps API |
| SDK | API + 補助機能 + ドキュメントをまとめた開発キット | レシピ、道具、材料が揃った料理キット | iOS SDK、Android SDK |
| Library | プログラム内で呼び出して使う事前作成済みコード | すぐ使えるレシピ集 | React、NumPy |
| Webhook | 逆向きのAPI。何か起きたときにサーバーがあなたに通知する | 荷物が届くと鳴るドアベル | Stripeの決済通知、GitHubのプッシュ通知 |
それぞれ、もう少し補足します。
- SDK: モバイルアプリを作るなら、SDKにはAPI、サンプルコード、ドキュメント、便利なユーティリティが一式そろっています。開発者と肩を並べて仕事をするのでなければ、直接触れる機会はそう多くないでしょう。
- Library: ライブラリは、他の誰かが書いたコードを自分のプログラムの中で使えるようにしたものです。内部でAPIを呼んでいることもありますが、システム同士をつなぐ通信路ではなく、あくまで開発者向けの道具です。
- Webhook: APIに「決済はもう通った？ いまは？」と何度も問い合わせる代わりに、webhookはこの関係を反転させます。イベントが起きた瞬間に、サーバーのほうからあなたへ通知が飛んでくるのです。ソフトウェア版のプッシュ通知だと思えば、しっくりきます。
2026年に「API」と口にするとき、ほとんどの場合は Web API、なかでもREST APIを指しています。とはいえ周辺の用語を知っておけば、ベンダーの提案やエンジニアとのSlackのやり取りで迷子にならずに済みます。
APIの主な種類と、出会う場面
アクセス範囲による分類
- 公開（オープン）API: 誰でも使えます。無料の天気APIや、Open-Meteo のような公開データAPIがその例です。
- 非公開（社内）API: 社内システム同士をつなぐために、企業の内側だけで使います。CRMと請求システムの連携などが典型です。
- パートナーAPI: 契約にもとづき、限られたビジネスパートナーにだけ共有されます。物流会社が小売業者に配送追跡データを渡すケースなどが当てはまります。
アーキテクチャによる分類
| 方式 | データ形式 | 向いている用途 | 初心者向けメモ |
|---|---|---|---|
| REST | 通常はJSON | Webアプリ、SaaS連携、公開API | まずはここから。86%の開発者 がRESTを使っています |
| SOAP | XML | 規制のある企業向け連携（銀行、医療） | スタックで必要な場合だけ学べば十分 |
| GraphQL | JSON | 必要な項目を細かく指定したい複雑なフロントエンド | RESTの基礎のあとに役立ちます |
| gRPC | Protocol Buffers | 社内マイクロサービス、低遅延サービス | たいていは開発・バックエンド領域です |
出典: Postman API protocols in 2023、GraphQL official docs、gRPC introduction。
ビジネスユーザーが主に触れるのは、REST APIとwebhookです。残りはベンダーとの会話で知っておくと便利なものの、SaaSのドキュメントやZapier連携、Thunderbitのようなツールの出発点は、基本的にRESTになります。
2026年のAI API: すべてを変えたユースケース
ひと昔前の「APIとは何か」記事は、誰もが最初に触るAPIはGoogle MapsかStripeだと描きがちでした。けれど2026年の現実は違います。多くの人が「API」という言葉に初めて出会うのは、ChatGPTに登録したとき、画像生成ツールを試したとき、あるいはAIスクレイピングツールを触ったとき、というのが実情です。
仕組みそのものは、AI APIも他のAPIと変わりません。プロンプトやドキュメント、URLといったリクエストを送ると、構造化された出力が返ってきます。違うのはサーバー側です。データベースの1行を引いてくる代わりに、サーバーがモデルを走らせるのです。
具体例を挙げると、こうなります。
- OpenAI API: テキストプロンプトを送る → AIが生成した応答が返る。
- 画像生成API: 説明文を送る → AIが生成した画像が返る。
- AIデータ抽出API: 雑然としたWebページを送る → きれいに構造化されたデータが返る。
ThunderbitでAIデータ抽出を試す Get Started Free
ThunderbitのOpen APIが、雑多なWebページを構造化データに変える仕組み
ここからは、いくらか私の主観が混じります。理由はお察しのとおりです。Thunderbit は、AIによるデータ抽出をプログラムから呼び出せるOpen APIを提供しています。
- Distill API: WebページのURLを送ると、解析やAIパイプラインへそのまま流せるきれいなMarkdownが返ってきます。コンテンツ分析、ナレッジベース構築、LLMワークフローへの入力にうってつけです。
- Extract API: スキーマ（フィールド名と型）を定義してURLを送ると、AIがそのスキーマに沿った構造化JSONデータを抜き出します。
簡単な例で見てみましょう。たとえば、ごちゃついたAmazonの商品ページのURLを、ThunderbitのExtract APIへ送るとします。
POST https://api.thunderbit.com/v1/extract
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"url": "https://example-store.com/products",
"fields": [
{ "name": "product_name", "type": "text" },
{ "name": "price", "type": "number" },
{ "name": "rating", "type": "number" }
]
}
すると、こう返ってきます。
{
"status": "success",
"data": [
{ "product_name": "Organic Cotton Tee", "price": 29.99, "rating": 4.7 },
{ "product_name": "Linen Button Shirt", "price": 54.00, "rating": 4.5 }
]
}
このレスポンスは、そのままスプレッドシートに貼り込めます。たった1回のAPI呼び出しで、何時間ぶんものコピペ作業が消えてなくなるわけです。Thunderbit Chrome拡張機能 は、同じAIエンジンをノーコードのUIの裏で動かしていますが、APIを通せば大規模な自動化が必要なチームにも同じ力を開放できます。
AIによる抽出が実務でどう動くのかをもっと知りたい方は、データ抽出とは何か や あらゆるWebサイトからデータを抽出する方法 のガイドものぞいてみてください。
最初のAPI呼び出し: ハンズオンのミニチュートリアル
所要2分。ダウンロードもインストールもコーディングも不要です。さっそく始めましょう。
ステップ1: ブラウザを開く
新しいブラウザのタブを開きます。
ステップ2: 無料のAPI URLを貼り付ける
次のURLをアドレスバーにコピー＆ペーストして、Enterキーを押します。
https://api.agify.io?name=michael
これで Agify API に GETリクエストを送り、「michael」という名前から推定される年齢を尋ねました。
ステップ3: JSONレスポンスを一緒に読む
こんな表示が現れるはずです。
{
"count": 304886,
"name": "michael",
"age": 61
}
"name"— 入力した名前"age"— APIの予測"count"— 使用されたデータ数
これで完了です。API呼び出しができました。
ステップ4: さらに一歩進める — 認証付きAPIを試す
次は、もう少し実務に近いものに挑戦してみましょう。OpenWeatherMap にアクセスして無料アカウントを作り、APIキーを取得します。そして YOUR_KEY を置き換えたうえで、このURLを貼り付けます。
https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_KEY&units=metric
今度は、自分が誰なのかをAPIキーで証明する必要がありました。これが 認証 です。実世界のAPIの多くは、こうやって動いています。
ステップ5: レスポンスコードを理解する
APIを呼ぶと、データではなくエラーが返ってくることもあります。よく見かけるステータスコードの意味は、次のとおりです。
| ステータスコード | 意味 |
|---|---|
| 200 OK | すべて成功。データを返します |
| 401 Unauthorized | APIキーが間違っているか、ありません |
| 404 Not Found | エンドポイントまたはリソースが存在しません |
| 429 Rate Limited | 短時間にリクエストを送りすぎました |
| 500 Internal Server Error | サーバー側で何か問題が起きました |
出典: MDN HTTP response status codes。
APIセキュリティをわかりやすく整理: キー、OAuth、JWTを1つの表で
認証レベルは、ここまでですでに2つ体験しています。何も認証しないAgifyと、APIキーを使う天気APIです。残りの2つを足せば、全体像が見えてきます。
| 認証方式 | 仕組み | よく使われる場面 | 複雑さ |
|---|---|---|---|
| 認証なし | 資格情報は不要。誰でもAPIを呼べる | 公開・読み取り専用データ（名前予測、オープンデータセット） | 非常に低い |
| APIキー | 各リクエストに含める1つの秘密文字列 | シンプルなデータアクセス（天気データ、ThunderbitのOpen API） | 低い |
| OAuth 2.0 | サードパーティのログインフローを通じて、ユーザーが限定的な権限を許可する | ユーザーデータへのアクセス（Google、Spotify、SNSログイン） | 中程度 |
| JWT（JSON Web Token） | ユーザー識別情報と権限を含む署名付きトークン | 現代のWebアプリでのステートレス認証 | 中〜高 |
出典: OAuth 2.0 RFC 6749、JWT RFC 7519。
あのAgifyのURLを貼り付けたときは、認証なしでした。天気APIキーを足したときは、APIキー認証を使っていました。OAuthとJWTは、アプリがあなたの個人データに触れる必要があるときに登場します。「Googleでログイン」をクリックする、まさにあの瞬間です。
ThunderbitのChrome拡張機能は、ブラウザにログイン済みのセッションをそのまま利用します（スクレイピング用に別のAPIキーは要りません）。一方、ThunderbitのOpen API は標準的なBearerトークン認証を使います。ひとつの製品の中で、この2つのモデルを実用的に使い分けている好例です。
APIキーを安全に保つには
- APIキーを表に出さない（スクリーンショット、共有ドキュメント、公開リポジトリはすべてNG）。
- 共有ドキュメントやスプレッドシートにキーを直接書き込まない。
- 開発者なら環境変数やシークレットマネージャーを使う。
- 定期的に、そして漏えいが疑われる場合はすぐに、キーをローテーションする。
すでに毎日使っている実例
おそらく今日の昼までに、気づかぬうちに6つ以上のAPIを使っていたはずです。
- ビジネスサイトに埋め込まれたGoogleマップ: サイトはGoogle Maps APIで地図を取得・表示しています。目に映るのは地図ですが、裏側ではAPI呼び出しが走っています。出典: Google Maps Platform docs。
- 「Google/Facebookでサインイン」: 新しいアカウントを作らずにログインできる、OAuthベースのAPIです。
- 決済処理（Stripe、PayPal）: オンライン決済の際、APIが店舗と決済事業者のあいだで支払いをさばきます。出典: Stripe API docs。
- 天気アプリ: スマホの天気アプリは、開くたびに天気APIを呼び出しています。
- AIチャットボットとアシスタント: ChatGPT、Claude、AIスクレイピングツールは、どれも機能をAPI経由で届けています。
- Spotifyのレコメンドエンジン: Spotifyがプレイリストを提案するとき、裏ではAPIがトラックデータ、ユーザーの好み、モデルの予測をやり取りしています。
- ThunderbitのAI Web Scraper: AIで あらゆるWebサイトから構造化データを抽出 し、いまではチームが大規模に抽出を自動化できるよう、Open APIも提供しています。
自分のビジネスに合ったAPIの選び方
APIを選ぶとき、あるいは開発チームの選定を手伝うときは、次の観点を確かめておくとよいでしょう。
| 判断基準 | 見るべきポイント |
|---|---|
| ドキュメント品質 | 分かりやすいか。非開発者でも例を追えるか。 |
| 料金体系 | 無料枠はあるか。従量課金か。クレジット制か（Thunderbit のように）？ |
| 認証方法 | 設定はどれくらい複雑か。APIキー、OAuth、JWTのどれか？ |
| レート制限 | 1分、1日あたり何リクエスト送れるか？ |
| データ形式 | JSON、CSV、Markdownのどれで返るか？ |
| サポートとコミュニティ | ヘルプセンター、コミュニティフォーラム、カスタマーサポートはあるか？ |
ざっくり比べると、こうなります。
| 種類 | 無料の公開API（例: Agify） | Thunderbit Open API | Google Maps API |
|---|---|---|---|
| 認証 | なし | APIキー（Bearerトークン） | APIキー |
| 料金 | 無料 | クレジット制、無料枠あり | 従量課金、無料枠あり |
| データ形式 | JSON | JSON / Markdown | JSON |
| レート制限 | 比較的寛大 | プランごと | プランごと |
| ドキュメント | 最小限 | 詳細（docs） | 充実 |
Treblleの2025年 API Intelligence Report によると、企業が管理するAPIエンドポイントは平均で 613個 にのぼり、55% が少なくとも500個を抱えています。これだけの数になれば、ドキュメント、サポート、明確な料金体系が重視されるのも当然です。
APIと自動データ入力: 概念が実務になるところ
APIが本当に面白くなるのは、どの業務フローでもいちばん厄介な部分——つまりデータ入力にぶつけたときです。
手作業のデータ入力は、いまも企業に年間で数十億ドル規模のコストを背負わせています。そのうえ、データ入力の平均エラー率はおよそ1% とされます。1万件のデータセットなら100件のミスですから、小さい数字に見えても侮れません。金融、医療、ECでは、わずか数件のミスが商談を壊したり、コンプライアンス上の問題を招いたりします。
自動データ入力システムは、APIにOCR、AI、機械学習を組み合わせ、データの取得・抽出・検証・出力までを担います。人がタブを行き来してコピー＆ペーストする必要はもうありません。一般的な流れは、こうなります。
- データ取得: システムがソース（Webページ、PDF、画像、フォームなど）からデータを読み取る。
- 抽出: AIまたはOCRが、関連するフィールドを見分けて取り出す。
- 検証: ルールにもとづき、エラー、重複、欠損値をチェックする。
- 出力: 整ったデータが、スプレッドシート、CRM、ERP、データベースへ流し込まれる。その多くはAPI経由です。
Thunderbitは、この流れのなかでAIによる抽出レイヤーとして働きます。Chrome拡張機能 を使えば、ビジネスユーザーはWebページを開いて「AIでフィールドを提案」をクリックするだけで、どの列を抜き出すかをAIに委ねられます。コードも手間もいりません。抽出したデータは、Excel、Google Sheets、Airtable、Notion へそのまま出力できます。さらに大規模な自動化が必要なチームには、ThunderbitのOpen API が同じAIをプログラム可能なエンドポイントとして提供します。
| アプローチ | 導入時間 | 精度 | 拡張性 | 向いている用途 |
|---|---|---|---|---|
| 手作業のデータ入力 | なし | 低い（ミスが起きやすい） | 非常に低い | 単発の小さな作業 |
| 旧来型の自動化（マクロ、スクリプト） | 長い | 中程度 | 中程度 | IT管理の反復ワークフロー |
| AI搭載ツール（Thunderbitなど） | 短い | 高い | 高い | ビジネスユーザー、複数サイトの抽出 |
自動データ入力の実例をもっと見たい方は、データ入力自動化の解説 や 企業におけるデータ自動化のメリット もどうぞ。
よくある質問
1. APIは何の略ですか？
APIは Application Programming Interface の略です。2つのソフトウェアが通信するためのルールの集まりで、片方がデータや処理を頼み、もう片方が構造化された形式で応えます。
2. APIを使うのにコードを知っている必要がありますか？
必ずしも必要ありません。多くのAPIは、ブラウザ、Postman、あるいはZapierのようなノーコードツールから呼び出せます。ThunderbitのChrome拡張機能のようなツールは、裏でAPIを使いながら、コードを書かずに扱えるようになっています。Open API はプログラム向けですが、社内ツールや自動化プラットフォームを介せばビジネスチームでも利用できます。
3. APIはウェブサイトと同じですか？
いいえ。ウェブサイトは人が読み、クリックするためのものです。APIはプログラムが読むためのもので、見た目のあるWebページではなく、JSONのような構造化データを返します。同じドメインで公開されることはあっても、果たす役割はまったく別です。
4. APIは無料ですか？
無料のものもあります（公開データAPIなど）。ほかはフリーミアム（無料枠＋有料プラン）だったり、リクエストごとに課金されたりします。たとえばThunderbitのOpen APIは、テスト用の無料枠があるクレジット制です。料金、レート制限、利用規約は、必ず各提供元で確認してください。
5. APIキーとOAuthの違いは何ですか？
APIキーは、各リクエストに含める1つの秘密文字列で、シンプルで基本的なアクセスに向いています。OAuth 2.0 はもっと込み入った仕組みで、ユーザーがアプリに限定的な権限を与えるものです（「Googleでログイン」など）。これにより、アプリはユーザーのパスワードを見ることなく、特定のデータにアクセスできます。APIキーはアプリを識別し、OAuth は範囲を絞ったユーザー権限を付与します。
詳しく知る
