POST
https://api.milda.ai/v1/patents/summaryPatent Summary
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
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03
Request body
CompanyRequestCompanyRequesttypereq1 fields
company_idstringyesCompany ID.
04
Responses
200 Successful Response422 Validation Error
PatentSummarytype6 fields
n_patentsinteger | nullTotal number of patents for the company.
avg_family_sizenumber | nullAverage patent family size.
share_cited_pctnumber | nullPercentage of patents that have been cited.
share_high_value_pctnumber | nullPercentage of patents classified as high-value.
filings_per_yearobject | nullPer-year filing counts: {year: {'granted': int, 'not_granted': int}}.
officesobject | nullPer patent-office counts: {office_code: {'granted': int, 'not_granted': int}}.