POST
https://api.milda.ai/v1/publications/top-cited-worksTop Cited Works
application/json01
Description
Publications — Top Cited Works
POST /v1/publications/top-cited-works
The company's most-cited publications: works since 2010 that rank in the top 10% most-cited worldwide, 25 per page.
Request
company_id(required) — Company ID.page_no(default 1) — page of results, 25 works per page.
Response
results— list of works, each withtitle,year,doi,cited_by_countandcitation_percentilemeta—count(total works available),pageandper_page
Returns 204 No Content if the company has no such works, or the page is past the last one.
Credits
Charged a 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
TopCitedWorksRequestTopCitedWorksRequesttypereq2 fields
company_idstringyesCompany ID.
page_nointeger—Page number (25 works per page).min 1 · default 1
04
Responses
200 Successful Response422 Validation Error
TopCitedWorksResponsetype2 fields
+resultsCitedWork[]Top-cited works for the requested page.
titlestring | nullPublication title.
yearinteger | nullPublication year.
doistring | nullDigital Object Identifier.
cited_by_countinteger | nullNumber of times the work has been cited.
citation_percentilenumber | nullNormalized citation percentile (0-1); higher means more cited.
+metaPageMetaPagination metadata.
countintegerTotal number of top-cited works available.default 0
pageintegerCurrent page number.default 1
per_pageintegerWorks per page.default 25