DocsQuickstart

Quickstart

Learn how to authenticate and make your first semantic patent search request in minutes.

1. Get your API Key

To use the FindIP API, you need an API key. You can create one for free in the dashboard.

2. Make your first request

Use the /search endpoint to find patents using natural language.

Terminal
# POST request example
curl -X POST https://api.findip.ai/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "lithium ion battery thermal management", "top_k": 5 }'

3. Understand the response

The API returns a list of relevant patent chunks, sorted by semantic similarity score.

{
  "results": [
    {
      "id": "US-2024123456-A1",
      "score": 0.892,
      "text": "A thermal management system for a vehicle battery pack...",
      "metadata": {
        "title": "Battery Thermal System",
        "country": "US",
        "date": "2024-01-15"
      }
    }
  ],
  "total": 1,
  "time_ms": 124
}