Web of Science Journals API

{"openapi":"3.0.0","info":{"version":"1.0.0","title":"Web of Science™ Journals API","description":"This API provides journal-level metadata and metrics for all journals in the Journal Citation Reports™ covered in the Web of Science Core Collection, including the Journal Impact Factor™ and other new metrics. Integrate journal data into your internal systems or retrieve journal indicators for bibliometrics studies.\n\n## Resources\nThis API follows the REST approach to disclose resources in URL format. Only the GET method is currently available to perform requests over HTTP.\n\nThe API is available on the [Clarivate Developer Portal](https://developer.clarivate.com/apis/wos-journal). The access requires registration on the Portal and approval from the Clarivate Sales/Product teams to entitle to the API.\n\n## Credentials\nAll requests require authentication with an API Key authentication flow. For more details, check the [Guide](https://developer.clarivate.com/help/api-access#key_access).\n\n## Content\nYou can learn more about content at [Journal Citation Reports™ Product page](https://clarivate.com/products/scientific-and-academic-research/research-analytics-evaluation-and-management-solutions/journal-citation-reports/), or in the [documentation](https://jcr.help.clarivate.com/Content/home.htm).\n\n## <a name=\"search\"></a> Search (query parameter `q=`)\nThis API supports free-text search for a journal name, abbreviation, ISSN code, publisher, and Web of Science™ category name (only `/categories` endpoint). You need to provide a complete and valid ISSN code pattern; otherwise, the API will not look up for ISSN codes.\n\n### Boolean operators\n| Operator    | Description  | Example|\n|-----|-----|------------------|\n| + / \" \" | Search by two or more terms in the same field. Blank space is the same as an AND operator. The search retrieves all the records that contain the terms, e.g., | `/journals?q=matrix biology`<br> `/journals?q=nature+group` |\n| OR | Search by at least one term in the field. The search retrieves all the records that contain one of the terms, e.g., | `/journals?q=gas OR oil` |\n| NOT / - | Search by excluding specific terms. The search retrieves all the records that match the query specifics, e.g., | `/journals?q=genetics -nature` |\n\n### Special symbols\nThe wildcards ( __*__ ) are allowed in the search that starts with the search query&#58; `/journals?q=nano*` will search indications that start from __nano__&#58; for example, _Nanotechnology_ or _nanotubes_.\n\nPlease note&#58; the free text search query (with the parameter `q=`) should contain at least three symbols.\n\n## Filtering\nThe API supports several filters for Journals and Web of Science™ Categories, narrowing down the initial list of entities or search results.\n\nThere are two types of filters:\n\n- Filter by one or multiple **values**: *edition*, *categoryCode*, *jcrYear*, *jifQuartile*\n- Filter by **range**: *jif*, *jifPercentile*, *jci*,\n\n### Filter by values\nThe filter name goes before the equals sign, followed by one or multiple filter values, separated by a semicolon, like `categoryCode=RZ;RU`. You can combine various filters with or without the search. Filters are separated by an ampersand (**&amp;**): `q=nature&categoryCode=RU;KM&jcrYear=2018`\n\nPlease note&#58; filter by *jcrYear* allows only one year value as an input\n\n### <a name='range'></a> Filter by range\nThe API supports range filtering for Journal Impact Factor (*jif*) or Journal Impact Factor Percentile (*jifPercentile*) with the following operators:\n\n- ***eq*** (equal): if a Journal Impact Factor (Percentile) is equal to a specific number.<br /> For example: for `jif=eq:5.032` the result will include journals with Journal Impact Factor = 5.032.<br /> Not combinable with any other operator\n- ***gt*** (greater than): if a Journal Impact Factor (Percentile) is greater than a specific number.<br /> For example: for `jif=gt:5` the result will include journals with Journal Impact Factor = 5.001 and higher.<br /> Combinable with *lt* and *lte* operators\n- ***gte*** (greater than equal): if a Journal Impact Factor (Percentile) is greater than or equal to a specific number.<br /> For example: for `jif=gte:5` the result will include journals with Journal Impact Factor = 5.000 and higher.<br /> Combinable with *lt* and *lte* operators\n- ***lt*** (less than): if a Journal Impact Factor (Percentile) is less than a specific number.<br /> For example: for `jif=lt:5` the result will include journals with Journal Impact Factor = 4.999 and less.<br /> Combinable with *gt* and *gte* operators\n- ***lte*** (less than equal): if a Journal Impact Factor (Percentile) is less than a specific number.<br /> For example: for `jif=lte:5` the result will include journals with Journal Impact Factor = 5.000 and less.<br /> Combinable with *gt* and *gte* operators\n\nUse `AND` to combine two operators, e.g.,`jifPercentile=gte:50 AND lte:80` responses with all journals in a percentile range from 50% to 80% (both included).\n\n## Pagination\nTo ensure fast response time, each search or multiple entity calls (such as `/journals` or `/categories/ID/cited/year/YYYY`) retrieve only a certain number of hits/records.\n\nThere are two optional request parameters to browse along with the result&#58; _limit_ and _page_.\n\n- limit&#58; Number of returned results, ranging from 1 to 50 (default **10**)\n- page&#58; Specifying a page to retrieve (default **1**)\n\nMoreover, this information is shown in the response body, in the tag **metadata**&#58;\n\n```json\n\"metadata\": {\n  \"total\": 91,\n  \"page\": 1,\n  \"limit\": 10\n}\n```\n## Errors\nThe WoS Journals API uses conventional HTTP success or failure status codes. For errors, some extra information is included to indicate what went wrong in the JSON response. The list of HTTP codes is listed below.\n\n| Code  | Title  | Description |\n|---|---|---|\n| 400  | Bad request  | Request syntax error |\n| 401  | Unauthorized  | The API key is invalid or missed |\n| 404  | Not found  | The resource is not found |\n| 404  | Suppressed Title | Suppressed Journal from specific year. Read more at [https://jcr.help.clarivate.com/Content/title-suppressions.htm](https://jcr.help.clarivate.com/Content/title-suppressions.htm) |\n| 405 | Method not allowed | Method other than GET is not allowed |\n| 50X  | Server errors  | Technical error with servers|\nEach error response (except `401 Unauthorized` error) contains the code of the error, the title of the error and detailed description of the error: a misprint in an endpoint, wrong URL parameter, etc. The example of the error message is shown below:\n\n```json\n\"error\": {\n  \"status\": 404,\n  \"title\": \"Resource couldn't be found\",\n  \"details\": \"There is no information in WoS Journals API about the identifier ABC_DEF for the Journals content area. Sorry :(\"\n}\n```\nFor the `401 Unauthorized` error the response body is a little bit different:\n```json\n{\n  \"error_description\": \"The access token is missing\",\n  \"error\": \"invalid_request\"\n}\n```","license":{"name":"Clarivate Content as a Service Licence","url":"https://clarivate.com/download/product-service-terms/"}},"tags":[{"name":"Journals","description":"Journals"},{"name":"Categories","description":"Categories"}],"paths":{"/journals":{"get":{"tags":["Journals"],"summary":"Search and filter across JCR Journals","description":"The endpoint allows to search, filter, or browse across the Journals content.\n\nThe endpoint doesn't require any parameter to return results, although only main information for the first ten records sorted alphabetically will be retrieved.\n\nTo get comprehensive results, a set of parameters could be applied:\n- `q`: ISSN or title/publisher search\n- `edition`: filter by journal edition\n- `categoryCode`: filter by WoS journal category\n- `jcrYear`: filter by Journal Citation Report Year (since 1997)\n- `jif`: filter by Journal Impact Factor (JIF)\n- `jifPercentile`: filter by Journal Impact Factor Percentile (0-100)\n- `jifQuartile`: filter by Journal Impact Factor Rank Quartile\n- `jci`: filter by Journal Citation Indicator (JCI)\n- `limit`: set the limit of records on the page (1-50)\n- `page`: set the result page\n\nBy default, all the responses are sorted alphabetically, only in case of search the results will be sorted by relevance.\n\nThe response contains:\n- Main information about the number of records found, page and limit\n- Journals unique ID (based on JCR abbreviated title)\n- API Link to Journal record\n- Journal title\n- Search matches with the found phrase ***&lt;em&gt;*** *highlighted* ***&lt;/em&gt;*** - only if parameter `q` is requested\n- Category information (unique ID, category name, and edition) - only if the parameter `categoryCode` or `edition` is requested\n- Link to the Journal Citation Report - only if parameter `jcrYear` is requested\n- Metrics information (Impact metrics) - only if parameter `jif` or `jci` is requested\n- Metrics information (Source metrics) - only if parameter `jifPercentile` is requested\n- Ranks information (JIF rank and quartile within the category) - only if parameter `jifQuartile` is requested","parameters":[{"name":"q","in":"query","required":false,"description":"Free-text search by journal name (e.g. *Nature Genetics*), JCR abbreviation (e.g. *NAT GENET*), publisher (e.g. *PUBLIC LIBRARY SCIENCE*) or [ISSN / eISSN code](https://www.issn.org/understanding-the-issn/what-is-an-issn/) (e.g. *1061-4036*)\n\nThe search logic is described in the section [Search](#search).","schema":{"type":"string","example":"0945-053X"}},{"name":"edition","in":"query","required":false,"description":"Filter by Web of Science Citation Index. The following indexes (editions) are presented:\n- SCIE - Science Citation Index Expanded\n- SSCI - Social Sciences Citation Index\n- AHCI - Arts & Humanities Citation Index\n- ESCI - Emerging Sources Citation Index\n\nMultiple values are allowed, separated by a semicolon ( **;** )","schema":{"type":"string","enum":["SCIE","SSCI","AHCI","ESCI"]}},{"name":"categoryCode","in":"query","required":false,"description":"Filter journals by category identifiers.\n\nEach journal in JCR is assigned to at least one of the subject categories, indicating a general area of science or the social sciences. Journals may be included in more than one subject category.\n\nMultiple values are allowed, separated by a semicolon ( **;** )","schema":{"type":"string","example":"IP"}},{"name":"jcrYear","in":"query","required":false,"description":"Filter by Journal Citation Report year (from 1997).\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jif**, **jifPercentile**, **jifQuartile**, and **jci** filters\n\nOnly one value is allowed.","schema":{"type":"integer","format":"int32","example":2019}},{"name":"jif","in":"query","required":false,"description":"Filter by [Journal Impact Factor](http://jcr.help.clarivate.com/Content/jcr3-glossary.htm) (JIF).\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jif** filter\n\nFilter logic is described in the section [Filter by range](#range)","schema":{"type":"string","example":"gte:5.0"}},{"name":"jifPercentile","in":"query","required":false,"description":"Filter by [Journal Impact Factor Percentile](http://jcr.help.clarivate.com/Content/glossary-journal-impact-factor-percentile.htm), ranging from 0 to 100\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jifPercentile** filter\n\nFilter logic is described in the section [Filter by range](#range)","schema":{"type":"string","example":"gte:70.0 AND lte:90.0"}},{"name":"jifQuartile","in":"query","required":false,"description":"Filter by JIF quartile rank for a category, from highest to lowest based on their JIF value: <br />Q1 is represented by the top 25% of journals in the category; <br />Q2 is occupied by journals in the 25 to 50% group; <br />Q3 is occupied by journals in the 50 to 75% group; <br />Q4 is occupied by journals in the 75 to 100% group.\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jifQuartile** filter\n\nMultiple values are allowed, separated by a semicolon ( **;** )","schema":{"type":"string","enum":["Q1","Q2","Q3","Q4"]}},{"name":"jci","in":"query","required":false,"description":"Filter by [Journal Citation Indicator](http://jcr.help.clarivate.com/Content/jcr3-glossary.htm) (JCI).\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jci** filter\n\nFilter logic is described in the section [Filter by range](#range)","schema":{"type":"string"}},{"name":"jciQuartile","in":"query","required":false,"description":"Filter by JCI quartile rank for a category, from highest to lowest based on their JCI value:\nQ1 is represented by the top 25% of journals in the category;\nQ2 is occupied by journals in the 25 to 50% group;\nQ3 is occupied by journals in the 50 to 75% group;\nQ4 is occupied by journals in the 75 to 100% group.\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jciQuartile** filter\n\nMultiple values are allowed, separated by a semicolon ( **;** )","schema":{"type":"string","enum":["Q1","Q2","Q3","Q4"]}},{"name":"jciPercentile","in":"query","required":false,"description":"Filter by Journal Citation Indicator (JCI) percentile, ranging from 0 to 100\n\n**NOTE:** The filter **jcrYear** is mandatory while using **jciPercentile** filter\n\nFilter logic is described in the section [Filter by range](#range)","schema":{"type":"string","example":"gte:70.0 AND lte:90.0"}},{"name":"page","in":"query","required":false,"description":"Specifying a page to retrieve","schema":{"type":"integer","format":"int32","default":1}},{"name":"limit","in":"query","required":false,"description":"Number of returned results, ranging from 1 to 50","schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"Journal list is sorted alphabetically when retrieving without or with fitlers only, and by relevance when searching.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalList"},"examples":{"Journals full list":{"value":{"metadata":{"page":1,"limit":10},"hits":[{"id":"2D_MATER","self":"/journals/2D_MATER","name":"2D Materials"},{"id":"3_BIOTECH","self":"/journals/3_BIOTECH","name":"3 Biotech"},{"id":"3D_PRINT_ADDIT_MANUF","self":"/journals/3D_PRINT_ADDIT_MANUF","name":"3D Printing and Additive Manufacturing"},{"id":"4OR-Q_J_OPER_RES","self":"/journals/4OR-Q_J_OPER_RES","name":"4OR-A Quarterly Journal of Operations Research"},{"id":"ANAE","self":"/journals/ANAE","name":"A N A E-APPROCHE NEUROPSYCHOLOGIQUE DES APPRENTISSAGES CHEZ L ENFANT"},{"id":"AAOHN_J","self":"/journals/AAOHN_J","name":"AAOHN JOURNAL"},{"id":"AAPG_BULL","self":"/journals/AAPG_BULL","name":"AAPG BULLETIN"},{"id":"AAPS_J","self":"/journals/AAPS_J","name":"AAPS Journal"},{"id":"AAPS_PHARMSCI","self":"/journals/AAPS_PHARMSCI","name":"AAPS PHARMSCI"},{"id":"AAPS_PHARMSCITECH","self":"/journals/AAPS_PHARMSCITECH","name":"AAPS PHARMSCITECH"}]}},"Search by word \"PLOS\"":{"value":{"metadata":{"total":8,"page":1,"limit":10},"hits":[{"id":"PLOS_BIOL","self":"/journals/PLOS_BIOL","name":"PLOS BIOLOGY","matches":[{"field":"name","value":["<em>PLOS</em> BIOLOGY"]},{"field":"jcrTitle","value":["<em>PLOS</em> BIOL"]},{"field":"isoTitle","value":["<em>PLoS</em>. Biol."]}]},{"id":"PLOS_GENET","self":"/journals/PLOS_GENET","name":"PLoS Genetics","matches":[{"field":"name","value":["<em>PLoS</em> Genetics"]},{"field":"jcrTitle","value":["<em>PLOS</em> GENET"]},{"field":"isoTitle","value":["<em>PLoS</em> Genet."]}]},{"id":"PLOS_MED","self":"/journals/PLOS_MED","name":"PLOS MEDICINE","matches":[{"field":"name","value":["<em>PLOS</em> MEDICINE"]},{"field":"jcrTitle","value":["<em>PLOS</em> MED"]},{"field":"isoTitle","value":["<em>PLos</em> Med."]}]},{"id":"PLOS_ONE","self":"/journals/PLOS_ONE","name":"PLoS One","matches":[{"field":"name","value":["<em>PLoS</em> One"]},{"field":"jcrTitle","value":["<em>PLOS</em> ONE"]},{"field":"isoTitle","value":["<em>PLoS</em> One"]}]},{"id":"PLOS_PATHOG","self":"/journals/PLOS_PATHOG","name":"PLoS Pathogens","matches":[{"field":"name","value":["<em>PLoS</em> Pathogens"]},{"field":"jcrTitle","value":["<em>PLOS</em> PATHOG"]},{"field":"isoTitle","value":["<em>PLoS</em> Pathog."]}]},{"id":"PLOS_CLIN_TRIALS","self":"/journals/PLOS_CLIN_TRIALS","name":"PLoS Clinical Trials","matches":[{"field":"name","value":["<em>PLoS</em> Clinical Trials"]},{"field":"jcrTitle","value":["<em>PLOS</em> CLIN TRIALS"]},{"field":"isoTitle","value":["<em>PLos</em> Clin. Trials"]}]},{"id":"PLOS_COMPUT_BIOL","self":"/journals/PLOS_COMPUT_BIOL","name":"PLoS Computational Biology","matches":[{"field":"name","value":["<em>PLoS</em> Computational Biology"]},{"field":"jcrTitle","value":["<em>PLOS</em> COMPUT BIOL"]},{"field":"isoTitle","value":["<em>PLoS</em> Comput. Biol."]}]},{"id":"PLOS_NEGLECT_TROP_D","self":"/journals/PLOS_NEGLECT_TROP_D","name":"PLoS Neglected Tropical Diseases","matches":[{"field":"name","value":["<em>PLoS</em> Neglected Tropical Diseases"]},{"field":"jcrTitle","value":["<em>PLOS</em> NEGLECT TROP D"]},{"field":"isoTitle","value":["<em>Plos</em> Neglect. Trop. Dis."]}]}]}},"Filter by year (2004) and JIF (5.000-8.000)":{"value":{"metadata":{"total":159,"page":1,"limit":10},"hits":[{"id":"ACTA_CRYSTALLOGR_B","self":"/journals/ACTA_CRYSTALLOGR_B","name":"Acta Crystallographica Section B-Structural Science Crystal Engineering and Materials","journalCitationReports":[{"year":2004,"url":"/journals/ACTA_CRYSTALLOGR_B/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"5.418"}}},{"id":"ADV_DRUG_DELIVER_REV","self":"/journals/ADV_DRUG_DELIVER_REV","name":"ADVANCED DRUG DELIVERY REVIEWS","journalCitationReports":[{"year":2004,"url":"/journals/ADV_DRUG_DELIVER_REV/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"7.763"}}},{"id":"ADV_FUNCT_MATER","self":"/journals/ADV_FUNCT_MATER","name":"ADVANCED FUNCTIONAL MATERIALS","journalCitationReports":[{"year":2004,"url":"/journals/ADV_FUNCT_MATER/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"5.679"}}},{"id":"ADV_ATOM_MOL_OPT_PHY","self":"/journals/ADV_ATOM_MOL_OPT_PHY","name":"Advances In Atomic Molecular and Optical Physics","journalCitationReports":[{"year":2004,"url":"/journals/ADV_ATOM_MOL_OPT_PHY/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"7.214"}}},{"id":"ADV_CANCER_RES","self":"/journals/ADV_CANCER_RES","name":"Advances in Cancer Research","journalCitationReports":[{"year":2004,"url":"/journals/ADV_CANCER_RES/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"6.200"}}},{"id":"ADV_EXP_SOC_PSYCHOL","self":"/journals/ADV_EXP_SOC_PSYCHOL","name":"ADVANCES IN EXPERIMENTAL SOCIAL PSYCHOLOGY","journalCitationReports":[{"year":2004,"url":"/journals/ADV_EXP_SOC_PSYCHOL/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"6.231"}}},{"id":"ADV_IMMUNOL","self":"/journals/ADV_IMMUNOL","name":"Advances in Immunology","journalCitationReports":[{"year":2004,"url":"/journals/ADV_IMMUNOL/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"7.929"}}},{"id":"ADV_ORGANOMET_CHEM","self":"/journals/ADV_ORGANOMET_CHEM","name":"Advances in Organometallic Chemistry","journalCitationReports":[{"year":2004,"url":"/journals/ADV_ORGANOMET_CHEM/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"5.500"}}},{"id":"ADV_POLYM_SCI","self":"/journals/ADV_POLYM_SCI","name":"Advances in Polymer Science","journalCitationReports":[{"year":2004,"url":"/journals/ADV_POLYM_SCI/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"7.320"}}},{"id":"AGING_CELL","self":"/journals/AGING_CELL","name":"AGING CELL","journalCitationReports":[{"year":2004,"url":"/journals/AGING_CELL/reports/year/2004"}],"metrics":{"impactMetrics":{"jif":"5.960"}}}]}}}}}}}}},"/journals/{id}":{"get":{"tags":["Journals"],"summary":"Get journal by id","description":"A journal entity contains:\n- basic bibliographic information about the journal, including publisher, ISSN and e-ISSN (where available), open access status, language, frequency of publication, and Web of Science categorization.\n- links to the multi-year Journal Citation Report data, starting from 1997.\n\nFor more information about Journal inclusion in the index, please visit [this page](http://jcr.help.clarivate.com/Content/scope-notes.htm)","parameters":[{"name":"id","in":"path","required":true,"description":"Journal unique identifier\n\nCurrently an identifier is a JCR abbreviation, where blank spaces are substituted with underscores (e.g. *PLOS ONE* Journal has the ID **PLOS_ONE**)","example":"PLOS_ONE","schema":{"type":"string"}}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalRecord","example":{"id":"PLOS_ONE","name":"PLoS One","jcrTitle":"PLOS ONE","isoTitle":"PLoS One","issn":"1932-6203","previousIssn":[],"eIssn":"1932-6203","publisher":{"name":"PUBLIC LIBRARY SCIENCE","address":"1160 BATTERY STREET, STE 100, SAN FRANCISCO, CA 94111","countryRegion":"USA"},"firstIssueYear":2006,"language":"English","openAccess":{"startYear":2006},"categories":[{"url":"/categories/ROC","name":"MULTIDISCIPLINARY SCIENCES","edition":"SCIE"}],"journalCitationReports":[{"year":2019,"url":"/journals/PLOS_ONE/reports/year/2019"},{"year":2018,"url":"/journals/PLOS_ONE/reports/year/2018"},{"year":2017,"url":"/journals/PLOS_ONE/reports/year/2017"}]}}}}}}}},"/journals/{id}/reports/year/{year}":{"get":{"tags":["Journals"],"summary":"Get journal metrics for a year","description":"This endpoint returns the information about Journal Citation Report by year.\n\nThe response contains:\n- Journal name and link to the Journal entry\n- Key indications (metrics): impact, source and influence\n- Journal Impact Factor and ESI citations ranks\n- Journal Source Data\n- Three-year content analysis by country/region and organization\n- Links to the related Cited/Citing reports","parameters":[{"name":"id","in":"path","required":true,"description":"Journal unique identifier\n\nCurrently an identifier is a JCR abbreviation, where blank spaces are substituted with underscores (e.g. *PLOS ONE* Journal has the ID **PLOS_ONE**)","example":"PLOS_ONE","schema":{"type":"string"}},{"name":"year","in":"path","required":true,"description":"Journal Citation Report year (jcrYear)","example":2017,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalReports","example":{"year":2017,"suppressed":false,"onHold":false,"delisted":false,"journal":{"id":"PLOS_ONE","self":"/journals/PLOS_ONE","name":"PLoS One"},"metrics":{"impactMetrics":{"totalCites":582878,"jif":"2.766","jif5Years":3.352,"immediacyIndex":0.405},"influenceMetrics":{"eigenFactor":{"score":1.86157,"normalized":217.45},"articleInfluence":1},"sourceMetrics":{"citableItems":{"total":20328,"articlesPercentage":97.993},"jifPercentile":77.344,"halfLife":{"cited":5.6,"citing":8.5}},"citationDistribution":{"articleCitationMedian":4.2,"reviewCitationMedian":7.2,"unlinkedCitations":290,"timesCited":0,"articles":89,"reviews":4,"other":289}},"ranks":{"jif":[{"category":"MULTIDISCIPLINARY SCIENCES","edition":"SCIE","self":"/categories/RO_SCIE","rank":"15/64","quartile":"Q1","jifPercentile":77.344}],"jci":[{"category":"MULTIDISCIPLINARY SCIENCES","edition":"SCIE","self":"/categories/RO_SCIE","rank":"29/126","quartile":"Q1"}],"esiCitations":[{"category":"MULTIDISCIPLINARY","rank":"4/52","quartile":"Q1"}]},"sourceData":{"articles":{"count":19920,"references":939992},"reviews":{"count":408,"references":26497},"other":{"count":752,"references":1024}},"journalProfile":{"startYear":2015,"endYear":2017,"occurrenceCountries":[{"countryRegion":"USA","occurrence":20935},{"countryRegion":"CHINA MAINLAND","occurrence":12321},{"countryRegion":"GERMANY (FED REP GER)","occurrence":6072},{"countryRegion":"England","occurrence":5852},{"countryRegion":"Japan","occurrence":4384},{"countryRegion":"Canada","occurrence":3694},{"countryRegion":"France","occurrence":3651},{"countryRegion":"Australia","occurrence":3569},{"countryRegion":"Netherlands","occurrence":3098},{"countryRegion":"Spain","occurrence":3011}],"occurrenceOrganizations":[{"organization":"UNIVERSITY OF CALIFORNIA SYSTEM","occurrence":2326},{"organization":"UNIVERSITY OF LONDON","occurrence":1684},{"organization":"CENTRE NATIONAL DE LA RECHERCHE SCIENTIFIQUE (CNRS)","occurrence":1421},{"organization":"HARVARD UNIVERSITY","occurrence":1382},{"organization":"CHINESE ACADEMY OF SCIENCES","occurrence":1171},{"organization":"INSTITUT NATIONAL DE LA SANTE ET DE LA RECHERCHE MEDICALE (INSERM)","occurrence":1157},{"organization":"UNIVERSITY OF TEXAS SYSTEM","occurrence":824},{"organization":"JOHNS HOPKINS UNIVERSITY","occurrence":760},{"organization":"STATE UNIVERSITY SYSTEM OF FLORIDA","occurrence":745},{"organization":"HELMHOLTZ ASSOCIATION","occurrence":737}]},"journalData":{"cited":{"url":"/journals/PLOS_ONE/cited/year/2017","count":10680},"citing":{"url":"/journals/PLOS_ONE/citing/year/2017","count":24843}}}}}}}}}},"/journals/{id}/cited/year/{year}":{"get":{"tags":["Journals"],"summary":"Get journals that cite the journal for the JCR year","description":"Cited Journal data show how many citations a journal received in the JCR year. Cited journal data is relevant when analyzing metrics such as the Journal Impact Factor and Market Share.\n\nThe response contains:\n\n- Citing **Journal** with the link to WoS Journal API entity\n- **Cited Year (all)**:  The total number of citations from the citing journal. This total includes the number shown under each year and the number in the Rest column.\n- **Cited Year (10 years interval)**: Publication year of the cited articles.\n- **Cited Year (rest)**: All publication years of cited articles prior to the 10-year period defined by the table. For example, if the cited years shown are 2017-2008, the Rest column will show the number of citations from the citing journal in 2017 to articles published in the cited journal in 2007 and any earlier year.\n\n\nPlease see the detailed infomration in the [JCR Help page](http://jcr.help.clarivate.com/Content/cited-journal-data.htm)","parameters":[{"name":"id","in":"path","required":true,"description":"Journal unique identifier","example":"PLOS_ONE","schema":{"type":"string"}},{"name":"year","in":"path","required":true,"description":"Journal Citation Report Year (from 1997)","example":2017,"schema":{"type":"integer","format":"int32"}},{"name":"page","in":"query","required":false,"description":"Specifying a page to retrieve","schema":{"type":"integer","format":"int32","default":1}},{"name":"limit","in":"query","required":false,"description":"Number of returned results, ranging from 1 to 50","schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"Citing journals are sorted in descending order. At the top is the journal with the largest number of citations to the cited journal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalsCited","example":{"metadata":{"total":10680,"page":1,"limit":3},"hits":[{"journal":{"name":"ALL"},"citing":[{"year":"all","count":582878,"citableItems":5},{"year":"2017","count":8223,"citableItems":5},{"year":"2016","count":48516,"citableItems":5},{"year":"2015","count":90319,"citableItems":5},{"year":"2014","count":107550,"citableItems":5},{"year":"2013","count":116895,"citableItems":5},{"year":"2012","count":89692,"citableItems":5},{"year":"2011","count":55563,"citableItems":5},{"year":"2010","count":29008,"citableItems":5},{"year":"2009","count":17723,"citableItems":5},{"year":"2008","count":11917,"citableItems":5},{"year":"rest","count":7472,"citableItems":5}]},{"journal":{"name":"PLoS One","self":"/journals/PLOS_ONE"},"citing":[{"year":"all","count":28491,"citableItems":5},{"year":"2017","count":970,"citableItems":5},{"year":"2016","count":3352,"citableItems":5},{"year":"2015","count":5018,"citableItems":5},{"year":"2014","count":5021,"citableItems":5},{"year":"2013","count":5059,"citableItems":5},{"year":"2012","count":3864,"citableItems":5},{"year":"2011","count":2301,"citableItems":5},{"year":"2010","count":1257,"citableItems":5},{"year":"2009","count":739,"citableItems":5},{"year":"2008","count":523,"citableItems":5},{"year":"rest","count":387,"citableItems":5}]},{"journal":{"name":"Scientific Reports","self":"/journals/SCI_REP-UK"},"citing":[{"year":"all","count":24313,"citableItems":5},{"year":"2017","count":306,"citableItems":5},{"year":"2016","count":1961,"citableItems":5},{"year":"2015","count":3461,"citableItems":5},{"year":"2014","count":4271,"citableItems":5},{"year":"2013","count":4873,"citableItems":5},{"year":"2012","count":3951,"citableItems":5},{"year":"2011","count":2532,"citableItems":5},{"year":"2010","count":1297,"citableItems":5},{"year":"2009","count":812,"citableItems":5},{"year":"2008","count":536,"citableItems":5},{"year":"rest","count":313,"citableItems":5}]}]}}}}}}}},"/journals/{id}/citing/year/{year}":{"get":{"tags":["Journals"],"summary":"Get journals that were cited by the journal for the JCR year","description":"The response contains:\n\n- Cited **Journal** with the link to WoS Journal API entity\n- **Cited Year (all)**:  The total number of citations to the cited journal. This total includes the number shown under each year and the number in the Rest column.\n- **Cited Year (10 years interval)**: Publication year of the cited articles.\n- **Cited Year (rest)**: All publication years of cited articles prior to the 10-year period defined by the table. For example, if the cited years shown are 2017-2008, the Rest column will show the number of citations from the citing journal in 2017 to articles published in the cited journal in 2007 and any earlier year.\n\n\nPlease see the detailed infomration in the [JCR Help page](http://jcr.help.clarivate.com/Content/citing-journal-data.htm)","parameters":[{"name":"id","in":"path","required":true,"description":"Journal unique identifier","example":"PLOS_ONE","schema":{"type":"string"}},{"name":"year","in":"path","required":true,"description":"A citing Year","example":2017,"schema":{"type":"integer","format":"int32"}},{"name":"page","in":"query","required":false,"description":"Specifying a page to retrieve","schema":{"type":"integer","format":"int32","default":1}},{"name":"limit","in":"query","required":false,"description":"Number of returned results, ranging from 1 to 50","schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalsCiting","example":{"metadata":{"total":24843,"page":1,"limit":3},"hits":[{"journal":{"name":"ALL"},"cited":[{"year":"all","count":967513},{"year":"2017","count":13088},{"year":"2016","count":58302},{"year":"2015","count":75106},{"year":"2014","count":74206},{"year":"2013","count":70894},{"year":"2012","count":65753},{"year":"2011","count":59180},{"year":"2010","count":55339},{"year":"2009","count":49476},{"year":"2008","count":44381},{"year":"rest","count":401788}]},{"journal":{"name":"ALL OTHERS (67729)"},"cited":[{"year":"all","count":67729},{"year":"2017","count":1370},{"year":"2016","count":4720},{"year":"2015","count":5287},{"year":"2014","count":4786},{"year":"2013","count":4447},{"year":"2012","count":3880},{"year":"2011","count":3542},{"year":"2010","count":3102},{"year":"2009","count":2620},{"year":"2008","count":2408},{"year":"rest","count":31567}]},{"journal":{"name":"PLoS One","self":"/journals/PLOS_ONE"},"cited":[{"year":"all","count":28491},{"year":"2017","count":970},{"year":"2016","count":3352},{"year":"2015","count":5018},{"year":"2014","count":5021},{"year":"2013","count":5059},{"year":"2012","count":3864},{"year":"2011","count":2301},{"year":"2010","count":1257},{"year":"2009","count":739},{"year":"2008","count":523},{"year":"rest","count":387}]}]}}}}}}}},"/journals/{id}/history":{"get":{"tags":["Journals"],"summary":"Get journal changes by id","description":"Historical changes a journal by ID","parameters":[{"name":"id","in":"path","required":true,"description":"Journal unique identifier\n\nCurrently an identifier is a JCR abbreviation, where blank spaces are substituted with underscores (e.g. *PLOS ONE* Journal has the ID **PLOS_ONE**)","example":"SCAND_J_THORAC_CARD","schema":{"type":"string"}}],"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalHistoryRecord"},"example":{"name":[{"name":"SCANDINAVIAN CARDIOVASCULAR JOURNAL","year":{"start":1997,"end":2021}},{"name":"SCANDINAVIAN JOURNAL OF THO

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clarivate/refs/heads/main/openapi/clarivate-wos-journal-openapi.json