DocsSearch API (검색)

Search API

자연어 문장으로 특허를 검색할 수 있는 시맨틱 검색 엔진입니다. 한·미·일·중·유럽 5개국 특허를 한 번에 검색합니다.

검색 가이드

LLM 자연어 검색 방법과 파라미터를 활용한 세부 검색 조합 가이드는 좌측 메뉴의 검색 가이드를 참고하세요.

POST /search

자연어로 특허를 검색합니다. 다국어 질의를 지원합니다. (한국어, 영어, 일본어, 중국어)

요청 파라미터 (Request Parameters)

파라미터	타입	필수	기본값	설명
`query`	string	예	—	자연어 검색 질의 (문장형)
`top_k`	integer	아니오	10	반환할 결과 개수 (1–100)
`filters`	object	아니오	null	검색 필터 (아래 옵션 참고)
`rerank`	boolean	아니오	false	Cross-encoder 리랭킹 활성화 여부

필터 옵션 (Filter Options)

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 형식)

요청 예시 (Request Example)

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"]
  }
}'

응답 (Response)

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를 자동으로 확인하고, 일치하는 후보가 여러 개일 경우 후보군 목록을 반환합니다.

경로 및 쿼리 파라미터 (Path & Query Parameters)

파라미터	타입	필수	설명
`publication_id`	string (path)	예	문서 ID (예: KR102021000001A, US12261291B2)
`year`	integer (query)	아니오	공개 연도 (데이터베이스 탐색 성능 최적화용)
`sections`	string (query)	아니오	포함할 섹션 명시: abstract, claims, description 등
`include_figures`	boolean (query)	아니오	도면 메타 정보 포함 여부 (기본값: true)

GET /figures/{publication_id}/{filename}

특허 도면 이미지를 가져옵니다. 도면 파일명(filename)은 문서 상세 조회 응답에 포함되어 있습니다.

쿼리 파라미터 (Query Parameters)

파라미터	기본값	설명
`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와는 달리, 이 엔드포인트는 자연어 질의가 필요 없으며 데이터베이스에서 직접 그룹화 및 집계를 수행합니다.

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)