Citations: POST /v1/patents/citations

POSThttps://api.milda.ai/v1/patents/citations

Citations

application/json

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).
offset (default 0), limit (default 50, max 200) — pagination.

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).

Headers

nameinreqdescription

tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.

Request body

CitationsRequest

CitationsRequesttypereq3 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).min 1 · default 1

Responses

200 Successful Response422 Validation Error

CitationsResponsetypereq2 fields

+rowsCitation[]—Citations for the requested page, newest first.

company_patent_titlestring | null—Title of the company's patent.

company_patent_publication_nrstring | null—Publication number of the company's patent.

company_patent_linkstring | null—Link to the company's patent.

citation_datestring | null—Date the citation was made (YYYY-MM-DD).

related_patent_titlestring | null—Title of the patent on the other side of the citation.

related_patent_publication_nrstring | null—Publication number of the related patent.

related_patent_linkstring | null—Link to the related patent.

+related_applicantsApplicant[]—Applicants of the related patent.

namestring | null—Applicant name.

countrystring | null—Two-letter ISO 3166-1 alpha-2 country code.

totalinteger—Total number of citations available in this direction.default 0