POST
https://api.milda.ai/v1/publications/analyticsPublication Analytics
application/json01
Description
Publications — Analytics
POST /v1/publications/analytics
Publication analytics for a company: total publications, how many rank among the most-cited worldwide, and breakdowns by year and research topic.
Request
company_id(required) — Company ID.
Response
total_publications— total number of publications attributed to the companytop_1_percent_cited_share— share of publications in the top 1% most-cited worldwide (0–1)top_10_percent_cited_share— share of publications in the top 10% most-cited worldwide (0–1)publications_by_year— list of{year, works_count}, newest firstpublications_by_topic— list of{topic, works_count}, top research topics by publication count
Returns 204 No Content if the company has no publication data.
Credits
Charged a flat fee per call (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
PublicationAnalyticstype5 fields
total_publicationsintegerTotal number of publications attributed to the company.default 0
top_1_percent_cited_sharenumberShare of publications in the top 1% most-cited worldwide (0-1).default 0
top_10_percent_cited_sharenumberShare of publications in the top 10% most-cited worldwide (0-1).default 0
+publications_by_yearPublicationYearCount[]Publication counts per year, newest first.
yearinteger | nullPublication year.
works_countinteger | nullNumber of publications in that year.
+publications_by_topicPublicationTopicCount[]Top research topics by publication count.
topicstring | nullResearch topic name.
works_countinteger | nullNumber of publications in that topic.