DocsSearch API

Search API

A semantic search engine that lets you search patents with natural-language sentences. Search US · KR · JP · CN · EP patents in a single call.

Search guide

For LLM natural-language search techniques and detailed search-combination guides, see the Search Guide in the left sidebar.

POST /search

Search patents with natural language. Multilingual queries are supported (Korean, English, Japanese, Chinese).

Request parameters

Parameter	Type	Required	Default	Description
`query`	string	Yes	—	Natural-language search query (sentence form)
`top_k`	integer	No	10	Number of results to return (1–100)
`filters`	object	No	null	Search filters (see options below)
`rerank`	boolean	No	false	Enable cross-encoder reranking

Filter options

Pass a filters object to narrow results.

Filter	Type	Example	Description
`country_codes`	string[]	`["KR","US"]`	Country codes (KR, US, CN, JP, EP)
`kind_codes`	string[]	`["A1","B2"]`	Document kind codes
`applicants`	string[]	`["Samsung"]`	Applicant names (fuzzy / partial match)
`ipc_codes`	string[]	`["H01L21"]`	IPC classification codes (prefix match)
`publication_year_min`	integer	`2020`	Minimum publication year
`publication_year_max`	integer	`2025`	Maximum publication year
`filing_date_min`	string	`"2023-01-01"`	Minimum filing date (YYYY-MM-DD)
`filing_date_max`	string	`"2025-12-31"`	Maximum filing date (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}

Fetch full document details including abstract, claims, description, and figure metadata. This endpoint uses Smart Resolution — it auto-resolves ambiguous IDs and returns a candidate list when multiple matches exist.

Path & query parameters

Parameter	Type	Required	Description
`publication_id`	string (path)	Yes	Document ID (e.g. KR102021000001A, US12261291B2)
`year`	integer (query)	No	Publication year (database lookup optimization hint)
`sections`	string (query)	No	Sections to include: abstract, claims, description, etc.
`include_figures`	boolean (query)	No	Include figure metadata (default: true)

GET /figures/{publication_id}/{filename}

Fetch a patent drawing image. The filename is included in the document detail response.

Query parameters

Parameter	Default	Description
`size`	full	Image size: thumb (200px), medium (800px), full
`format`	original	Output format: original, png, jpg

POST /trends

Analyze natural-language patent trends for a given technology area. Returns grouped statistics by year, IPC class, applicant, and country.

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

Query patent statistics with SQL-style filters. Unlike /trends, this endpoint requires no natural-language query — it groups and aggregates directly from the database.

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

Trends & Portfolio Next: Authentication