DocsSearch API (検索)

Search API

自然言語で特許を検索できるセマンティック検索エンジンです。日・韓・米・中・欧の 5 か国の特許を 1 回の呼び出しで検索できます。

検索ガイド

LLM 自然言語検索のテクニックとパラメータを使った詳細な検索組み合わせガイドは左メニューの検索ガイドをご覧ください。

POST /search

自然言語で特許を検索します。多言語クエリに対応(韓国語・英語・日本語・中国語)。

リクエストパラメータ

パラメータ	型	必須	デフォルト	説明
`query`	string	はい	—	自然言語検索クエリ(文形式)
`top_k`	integer	いいえ	10	返却件数 (1–100)
`filters`	object	いいえ	null	検索フィルタ(下記参照)
`rerank`	boolean	いいえ	false	Cross-encoder リランキングの有効化

フィルタオプション

filters オブジェクトを渡すことで結果を絞り込めます。

フィルタ	型	例	説明
`country_codes`	string[]	`["KR","US"]`	国コード (KR, US, CN, JP, EP)
`kind_codes`	string[]	`["A1","B2"]`	文書種別コード (Kind Code)
`applicants`	string[]	`["Samsung"]`	出願人名(あいまい/部分一致)
`ipc_codes`	string[]	`["H01L21"]`	IPC 分類(プレフィックス一致)
`publication_year_min`	integer	`2020`	公開年の最小値
`publication_year_max`	integer	`2025`	公開年の最大値
`filing_date_min`	string	`"2023-01-01"`	出願日最小 (YYYY-MM-DD)
`filing_date_max`	string	`"2025-12-31"`	出願日最大 (YYYY-MM-DD)

リクエスト例

cURL — Search with filters

curl -X POST https://api.findip.ai/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "query": "lithium ion battery cathode material",
  "top_k": 20,
  "filters": {
    "country_codes": ["US", "KR"],
    "publication_year_min": 2022,
    "publication_year_max": 2025,
    "ipc_codes": ["H01M"]
  }
}'

レスポンス

200 OK

{
"results": [
  {
    "publication_id": "US12261291B2",
    "publication_number": "US12261291B2",
    "application_number": "17123456",
    "country_code": "US",
    "kind_code": "B2",
    "score": 0.0317,
    "invention_title": "Positive electrode active material for lithium ion secondary battery",
    "abstract": null,
    "filing_date": "2022-01-15",
    "publication_date": "2025-03-25",
    "ipc_codes": ["H01M 4/525", "H01M 4/36"],
    "applicants": ["COMPANY NAME"],
    "matched_paragraphs": [
      {
        "section": "description",
        "section_name": null,
        "claim_num": null,
        "text": "Examples of materials that have been mainly proposed..."
      }
    ]
  }
],
"total": 20,
"query_time_ms": 1829
}

GET /documents/{publication_id}

要約・クレーム・発明の詳細・図面メタを含む特許文書の全体情報を取得します。このエンドポイントは**スマート識別子解析 (Smart Resolution)**を採用しており、曖昧な ID を自動解析し、複数候補がある場合は候補一覧を返します。

パス・クエリパラメータ

パラメータ	型	必須	説明
`publication_id`	string (path)	はい	文書 ID (例: KR102021000001A, US12261291B2)
`year`	integer (query)	いいえ	公開年 (DB 検索の最適化ヒント)
`sections`	string (query)	いいえ	含めるセクション: abstract, claims, description など
`include_figures`	boolean (query)	いいえ	図面メタ情報を含めるか (デフォルト: true)

GET /figures/{publication_id}/{filename}

特許の図面画像を取得します。filename は文書詳細レスポンスに含まれます。

クエリパラメータ

パラメータ	デフォルト	説明
`size`	full	画像サイズ: thumb (200px), medium (800px), full
`format`	original	出力フォーマット: original, png, jpg

POST /trends

特定の技術分野について自然言語ベースで特許トレンドを分析します。年別・IPC 別・出願人別・国別の集計データを返します。

Request

curl -X POST https://api.findip.ai/trends \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "query": "electric vehicle autonomous driving",
  "country_codes": ["KR", "US"],
  "year_min": 2020,
  "year_max": 2025,
  "top_k": 1000,
  "include": ["by_year", "by_ipc", "by_applicant", "by_country"]
}'

POST /stats

SQL ベースのフィルタで特許統計をクエリします。/trends と異なり自然言語クエリは不要で、DB から直接集約します。

Request

curl -X POST https://api.findip.ai/stats \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "country_codes": ["KR", "US"],
  "year_min": 2020,
  "year_max": 2025,
  "ipc_codes": ["H01M"],
  "group_by": ["year", "ipc"],
  "limit": 10
}'

技術動向・ポートフォリオ Next: 認証 (Auth)