POST
https://api.milda.ai/v1/patents/citationsPatent Citations
application/json01
Description
Patents — Citations
POST /v1/patents/citations
Paginated list of individual patent-level citations to or from the company's patents.
Request
company_id(required) — Company ID.direction(required) — citation direction:incoming— patents that cite this company's patents (who builds on it).outgoing— patents that this company's patents cite (what it builds on).page_no(default 1) — page of results, 25 per page, up to page 400.
Response
rows— list of citations, newest first. Each row:company_patent_title,company_patent_publication_nr,company_patent_link— the company's patent.related_patent_title,related_patent_publication_nr,related_patent_link— the patent on the other side of the citation.related_applicants—{ name, country }of the related patent's applicants.citation_date.total— total citations available in this direction.
Returns 204 No Content if there are no citations in the requested direction.
Credits
Charged a small flat fee per page (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
CitationsRequestCitationsRequesttypereq3 fields
company_idstringyesCompany ID.
directionCitationDirectionyesCitation direction. `incoming` = patents that cite this company's patents (who builds on it); `outgoing` = patents that this company's patents cite (what it builds on).
page_nointeger—Page number (25 citations per page, up to 400).1–400 · default 1
04
Responses
200 Successful Response422 Validation Error
CitationsResponsetype2 fields
+rowsCitation[]Citations for the requested page, newest first.
Company patent
company_patent_titlestring | nullTitle of the company's patent.
company_patent_publication_nrstring | nullPublication number of the company's patent.
company_patent_linkstring | nullLink to the company's patent.
Related patent
related_patent_titlestring | nullTitle of the patent on the other side of the citation.
related_patent_publication_nrstring | nullPublication number of the related patent.
related_patent_linkstring | nullLink to the related patent.
+related_applicantsApplicant[]Applicants of the related patent.
namestring | nullApplicant name.
countrystring | nullTwo-letter ISO 3166-1 alpha-2 country code.
citation_datestring | nullDate the citation was made (YYYY-MM-DD).
totalintegerTotal number of citations available in this direction.default 0