POST
https://api.milda.ai/v1/publications/analyticsAnalytics
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
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
CompanyRequestCompanyRequesttypereq1 fields
company_idstringyesCompany ID.
04
Responses
200 Successful Response422 Validation Error
PublicationAnalyticstypereq5 fields
total_publicationsinteger—Total number of publications attributed to the company.default 0
top_1_percent_cited_sharenumber—Share of publications in the top 1% most-cited worldwide (0-1).default 0
top_10_percent_cited_sharenumber—Share of publications in the top 10% most-cited worldwide (0-1).default 0
+publications_by_yearPublicationYearCount[]—Publication counts per year, newest first.
yearinteger | null—Publication year.
works_countinteger | null—Number of publications in that year.
+publications_by_topicPublicationTopicCount[]—Top research topics by publication count.
topicstring | null—Research topic name.
works_countinteger | null—Number of publications in that topic.