`patent-mining`POST

Run Patent Mining subagents: landscape, Markush extract, or structure similarity.

Programmatic access to the /patents tool. Use `subagent` to select Patent Landscape, Markush Extract, or Structure Similarity.

Endpoint

POST https://api.frontwind.ai/v1/agents/patent-mining

Example

curl -X POST https://api.frontwind.ai/v1/agents/patent-mining \
  -H "Authorization: Bearer fw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "subagent": "patent_landscape", "drug_name": "trastuzumab" }'

Request body

Field	Type	Required	Description
`subagent`	`string`	Yes	Which /patents mode to run.
`drug_name`	`string`	No	Required for patent_landscape, e.g. 'trastuzumab'.
`patent_id`	`string`	No	Required for markush_extract, e.g. 'US10123456B2'.
`target`	`string`	No	Required for structure_similarity, e.g. 'EGFR'.
`sub_modality`	`string`	default "conventional"
`query_smiles`	`string`	No	Required for structure_similarity.
`max_candidates`	`integer`	default 300
`min_similarity`	`number`	default 0.3

Response data

Field	Type	Description
`subagent`	`string`
`summary`	`string`
`result`	`object`	Native result from the selected subagent. For patent_landscape: { drug, patents, n_patents, run_id, query_id }.

Example response

{
  "ok": true,
  "agent": "patent-mining",
  "data": {
    "subagent": "patent_landscape",
    "summary": "54 patents for trastuzumab",
    "result": {
      "drug": {
        "name": "trastuzumab",
        "company": "Genentech / Roche",
        "licensor": "",
        "licensor_acquirer": "",
        "alt_names": [
          "Herceptin"
        ],
        "target": "HER2",
        "modality_type": "antibody"
      },
      "n_patents": 54,
      "run_id": "drugrun_1715731200_trastuzumab",
      "query_id": 12345,
      "patents": [
        {
          "patent_id": "US-8211429-B2",
          "title": "Treatment with anti-ErbB2 antibodies",
          "assignee": "Genentech",
          "filing_date": "2006-08-25",
          "priority_date": "2005-08-25",
          "publication_date": "2012-07-03",
          "family_id": "12345678",
          "jurisdiction": "US",
          "link": "https://patents.google.com/patent/US8211429B2/en",
          "score": 92,
          "match_type": "direct",
          "triage": "keep",
          "classification": "CORE MOLECULE PATENT",
          "classification_confidence": "high",
          "claim_basis": "composition claims",
          "secondary_type": "",
          "relevance": "direct",
          "claim_type": "composition",
          "summary": "Covers anti-HER2 antibody treatment claims.",
          "family_tree": null
        }
      ]
    }
  },
  "elapsed_s": 42
}