# searchPatents

**Identifier:** `patentsview_searchPatents`

**Provider:** [PatentsView](https://kirha.com/providers/patentsview.md)

Search for patents using a text query, an applicant/company name, or both combined. Use applicantType to filter by company or individual applicants.

## Run it with the CLI

```bash
kirha tools run patentsview_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": "patentsview_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": {
    "applicantName": {
      "description": "e.g., 'Google', 'Apple'",
      "type": "string"
    },
    "applicantType": {
      "description": "company keeps patents with a named organization applicant, individual keeps the others; omit for both",
      "enum": [
        "individual",
        "company"
      ],
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "number"
    },
    "query": {
      "description": "e.g., 'solar energy', 'machine learning'",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "applicationNumbers": {
      "description": "Application numbers for use with getPatentDetails",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "patents": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "applicants": {
            "description": "Individual inventor/applicant names",
            "type": "string"
          },
          "applicationNumber": {
            "type": "string"
          },
          "applicationType": {
            "description": "e.g., Utility, Design, Plant",
            "type": "string"
          },
          "companyName": {
            "description": "Company/organization name when applicant is a company",
            "type": "string"
          },
          "cpcClassifications": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "examinerName": {
            "type": "string"
          },
          "filingDate": {
            "type": "string"
          },
          "grantDate": {
            "type": "string"
          },
          "inventorCountries": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "patentNumber": {
            "type": "string"
          },
          "statusDescription": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "applicationNumber",
          "title",
          "filingDate"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "totalResults": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "patents",
    "totalResults",
    "applicationNumbers"
  ],
  "type": "object"
}
```

## Related tools

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

- [`getPatentDetails`](https://kirha.com/providers/patentsview/getPatentDetails.md)

-----

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