LargitData 開発者ポータル

LargitData には 2 種類のプログラマブルなインターフェースがあります。 公開コンテンツ API は無料・読み取り専用・認証不要で、 本サイトが HTML として公開している製品カタログ、ナレッジベース索引、ブログをそのまま返します。 商用データ API（ソーシャルメディア API と越境EC データ API）は 契約に基づいて提供されるサービスで、API キーで認証します。 前者はこのページだけで利用を開始でき、後者はトライアルキーの申請から始まります。

クイックスタート

登録もキーも SDK も不要です。1 行で取得できます:

curl -s https://www.largitdata.com/api/v1/products | jq '.data[].id'

利用可能なリソースを知るには、サービス索引から始めてください:

curl -s https://www.largitdata.com/api/v1/

以下のすべてのエンドポイントの機械可読な仕様は /openapi.json にあります（YAML 版）。コードジェネレーターにそのまま渡せます:

npx @openapitools/openapi-generator-cli generate \
  -i https://www.largitdata.com/openapi.json \
  -g python -o ./largitdata-client

エンドポイント一覧

ベース URL: https://www.largitdata.com/api/v1/。すべてのエンドポイントは GET のみ対応で （HEAD と OPTIONS にも応答します）、CORS によりどのオリジンからでも読み取れます。

lang は zh-tw（既定）、en、ja のいずれかです。 page_size は 1 から 100 の範囲で、既定値は 50 です。

カタログに含まれる製品

レスポンス形式

成功レスポンスはすべて同じ構造です。コレクション系は meta と links を伴い、 単一リソースは data のみを返します。

{
  "data": [ { "id": "infominer", "name": "InfoMiner ...", "url": "https://..." } ],
  "meta": { "total": 9, "page": 1, "page_size": 50, "total_pages": 1, "lang": "ja" },
  "links": {
    "self": "https://www.largitdata.com/api/v1/products?page=1",
    "next": null,
    "prev": null,
    "documentation": "https://www.largitdata.com/developers/"
  }
}

ページ送りは links.next が null になるまで辿ってください。 レスポンスは 10 分間キャッシュ可能で、X-API-Version ヘッダーを含みます。

エラーとエラーコード

エラーが HTML で返ることはありません。/api/ 配下の失敗はすべて RFC 9457 の application/problem+json で、安定した code と 復旧方法を示す hint を含みます:

{
  "type": "https://www.largitdata.com/developers/#error-invalid_parameter",
  "title": "Bad Request",
  "status": 400,
  "code": "invalid_parameter",
  "detail": "page_size=9999 is outside the supported range.",
  "instance": "/api/v1/pages",
  "hint": "page_size must be an integer between 1 and 100.",
  "documentation_url": "https://www.largitdata.com/developers/",
  "parameter": "page_size"
}

API 以外のパスが存在しない場合は、本物の HTTP 404 を返します。 Accept: text/markdown を送ると、体裁付きの HTML エラーページではなく、 次に参照すべき場所を列挙した markdown ドキュメントが返ります。

機械可読リソース

プログラムや AI エージェントがスクレイピングなしで本サイトを辿るためのリソースです:

商用 API と認証

LargitData の 2 つのサービスは本サイトからではなく契約に基づいてデータを提供します。 認証には X-API-Key リクエストヘッダーを使用します:

curl -H "X-API-Key: $LARGITDATA_API_KEY" https://<割り当てホスト>/...

トライアルキーのご希望は [email protected] までメールでご連絡ください。対象プラットフォーム、キーワードまたはカテゴリの範囲、 想定リクエスト量、希望する納品形式をお知らせいただければ、トライアルキー、 該当範囲のエンドポイントドキュメント、連携サポートをご返信します。

公正利用とサポート

• 公開コンテンツ API に現時点でレート制限はありません。おおむね毎秒 1 リクエスト以内に抑え、 識別可能な User-Agent を設定してください。影響のある変更の前にご連絡できます。
• レスポンスは 10 分間キャッシュ可能です。ポーリングではなく Cache-Control に従ってください。
• API が返すコンテンツはサイト利用規約の対象です。再掲載時は LargitData への出典表記が必要です。
• 互換性を壊す変更には新しいバージョンプレフィックス（/api/v2/）を使います。 /api/v1/ の契約は維持されます。