POST
https://api.milda.ai/v1/patents/summarySummary
application/json01
Description
Patents — Summary
POST /v1/patents/summary
Headline patent KPIs for a company.
Request
company_id(required) — Company ID.
Response
n_patents— total patents.avg_family_size— average patent family size.share_cited_pct— % of patents that have been cited.share_high_value_pct— % of patents classified as high-value.filings_per_year— per year:{ year: {granted, not_granted} }.offices— per patent office:{ office_code: {granted, not_granted} }.
Returns 204 No Content if the company has no patent data.
Credits
Charged a small flat fee per request (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
CompanyRequestCompanyRequesttypereq1 fields
company_idstringyesCompany ID.
04
Responses
200 Successful Response422 Validation Error
PatentSummarytypereq6 fields
n_patentsinteger | null—Total number of patents for the company.
avg_family_sizenumber | null—Average patent family size.
share_cited_pctnumber | null—Percentage of patents that have been cited.
share_high_value_pctnumber | null—Percentage of patents classified as high-value.
filings_per_yearobject | null—Per-year filing counts: {year: {'granted': int, 'not_granted': int}}.
officesobject | null—Per patent-office counts: {office_code: {'granted': int, 'not_granted': int}}.