# searchPatents

**Identifier:** `lens_searchPatents`

**Provider:** [Lens](https://kirha.com/providers/lens.md)

Search the Lens global patent database with full-text queries and optional filters for applicant, owner, inventor, sequence organism, jurisdiction, date range, legal status, classification, and publication type. Also supports batch patent lookup by Lens IDs or document numbers. Each result already includes title, applicants, inventors (single strings whose format varies by source office: "DING, Dawei", "DAS POULAMI" and "Mark Turner" all occur, so normalise before matching them against another provider), abstract, legal status, and citation and family counts, so getPatent is not needed just to read inventors. Use getPatent for claims, description, classifications, and full details on a specific patent, and searchScholarlyWorks for the related scientific literature.

## Run it with the CLI

```bash
kirha tools run lens_searchPatents \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "lens_searchPatents",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "applicant": {
      "description": "Company or brand name, e.g., Pasqal also matches PASQAL SAS. If 0 results, list legal-name variants with aggregatePatents top_applicants",
      "type": "string"
    },
    "classificationCpc": {
      "description": "e.g., A61K31/00, G06N3",
      "type": "string"
    },
    "classificationIpc": {
      "description": "e.g., C12N15/00",
      "type": "string"
    },
    "dateFrom": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "dateTo": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "from": {
      "default": 0,
      "maximum": 9999,
      "minimum": 0,
      "type": "number"
    },
    "inventor": {
      "description": "e.g., Jennifer Doudna",
      "type": "string"
    },
    "jurisdiction": {
      "description": "e.g., US, EP, CN, JP, WO",
      "type": "string"
    },
    "legalStatus": {
      "enum": [
        "ACTIVE",
        "PENDING",
        "DISCONTINUED",
        "INACTIVE",
        "EXPIRED",
        "PATENTED",
        "UNKNOWN"
      ],
      "type": "string"
    },
    "lensIds": {
      "description": "Batch lookup by Lens IDs. Ignores other filters.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "organism": {
      "description": "Organism of disclosed biological sequences, e.g., Homo sapiens",
      "type": "string"
    },
    "owner": {
      "description": "Current owner (after assignments), e.g., Tesla",
      "type": "string"
    },
    "patentIds": {
      "description": "Batch lookup by patent IDs, e.g., US 8625931, EP_0227762_B1",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "publicationType": {
      "enum": [
        "PATENT_APPLICATION",
        "GRANTED_PATENT",
        "ABSTRACT",
        "SPC",
        "DESIGN_RIGHT",
        "LIMITED_PATENT",
        "PLANT_PATENT"
      ],
      "type": "string"
    },
    "query": {
      "description": "Searches title, abstract and claims; all terms required. Supports OR, NOT, \"phrases\". e.g., CRISPR gene editing",
      "type": "string"
    },
    "size": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "sort": {
      "default": "date_published_desc",
      "enum": [
        "relevance",
        "date_published_desc",
        "date_published_asc",
        "cited_by_count_desc"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "lensIds": {
      "description": "Lens IDs for composition with getPatent, getPatentFamily, getPatentCitations",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "patents": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "abstract": {
            "type": "string"
          },
          "applicants": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "datePublished": {
            "type": "string"
          },
          "docNumber": {
            "type": "string"
          },
          "forwardCitationCount": {
            "type": "number"
          },
          "granted": {
            "type": "boolean"
          },
          "inventors": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "jurisdiction": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "legalStatus": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          },
          "publicationType": {
            "type": "string"
          },
          "simpleFamilySize": {
            "type": "number"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "lensId",
          "applicants",
          "inventors"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "total",
    "patents",
    "lensIds"
  ],
  "type": "object"
}
```

## Related tools

Other Lens tools that this tool refers to, or that refer to it.

- [`getPatentCitations`](https://kirha.com/providers/lens/getPatentCitations.md)
- [`getPatentFamily`](https://kirha.com/providers/lens/getPatentFamily.md)
- [`getScholarlyWork`](https://kirha.com/providers/lens/getScholarlyWork.md)
- [`searchScholarlyWorks`](https://kirha.com/providers/lens/searchScholarlyWorks.md)
- [`getPatent`](https://kirha.com/providers/lens/getPatent.md)
- [`aggregatePatents`](https://kirha.com/providers/lens/aggregatePatents.md)
- [`getScholarlyCitations`](https://kirha.com/providers/lens/getScholarlyCitations.md)

-----

[All Lens tools](https://kirha.com/providers/lens.md) · [< Back to tools list](https://kirha.com/tools.md)