The endpoint allows to search, filter, or browse across the Journals content.
The endpoint doesn't require any parameter to return results, although only main information for the first ten records sorted alphabetically will be retrieved.
To get comprehensive results, a set of parameters could be applied:
q: ISSN or title/publisher searchedition: filter by journal editioncategoryCode: filter by WoS journal categoryjcrYear: filter by Journal Citation Report Year (since 1997)jif: filter by Journal Impact Factor (JIF)jifPercentile: filter by Journal Impact Factor Percentile (0-100)jifQuartile: filter by Journal Impact Factor Rank Quartilejci: filter by Journal Citation Indicator (JCI)limit: set the limit of records on the page (1-50)page: set the result page
By default, all the responses are sorted alphabetically, only in case of search the results will be sorted by relevance.
The response contains:
- Main information about the number of records found, page and limit
- Journals unique ID (based on JCR abbreviated title)
- API Link to Journal record
- Journal title
- Search matches with the found phrase <em> highlighted </em> - only if parameter
q is requested
- Category information (unique ID, category name, and edition) - only if the parameter
categoryCode or edition is requested
- Link to the Journal Citation Report - only if parameter
jcrYear is requested
- Metrics information (Impact metrics) - only if parameter
jif or jci is requested
- Metrics information (Source metrics) - only if parameter
jifPercentile is requested
- Ranks information (JIF rank and quartile within the category) - only if parameter
jifQuartile is requested
- Query
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 (e.g. 1061-4036)
The search logic is described in the section Search.
- Edition
Filter by Web of Science Citation Index. The following indexes (editions) are presented:
- SCIE - Science Citation Index Expanded
- SSCI - Social Sciences Citation Index
- AHCI - Arts & Humanities Citation Index
- ESCI - Emerging Sources Citation Index
Multiple values are allowed, separated by a semicolon ( ; )
- Category Code
Filter journals by category identifiers.
Each 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.
Multiple values are allowed, separated by a semicolon ( ; )
- JCR Year
Filter by Journal Citation Report year (from 1997).
NOTE: The filter jcrYear is mandatory while using jif, jifPercentile, jifQuartile, and jci filters
Only one value is allowed.
- JIF
Filter by Journal Impact Factor (JIF).
NOTE: The filter jcrYear is mandatory while using jif filter
Filter logic is described in the section Filter by range
- JIF Percentile
Filter by Journal Impact Factor Percentile, ranging from 0 to 100
NOTE: The filter jcrYear is mandatory while using jifPercentile filter
Filter logic is described in the section Filter by range
- JIF Quartile
Filter by JIF quartile rank for a category, from highest to lowest based on their JIF value:
Q1 is represented by the top 25% of journals in the category;
Q2 is occupied by journals in the 25 to 50% group;
Q3 is occupied by journals in the 50 to 75% group;
Q4 is occupied by journals in the 75 to 100% group.
NOTE: The filter jcrYear is mandatory while using jifQuartile filter
Multiple values are allowed, separated by a semicolon ( ; )
- JCI
Filter by Journal Citation Indicator (JCI).
NOTE: The filter jcrYear is mandatory while using jci filter
Filter logic is described in the section Filter by range
- JCI Quartile
Filter by JCI quartile rank for a category, from highest to lowest based on their JCI value:
Q1 is represented by the top 25% of journals in the category;
Q2 is occupied by journals in the 25 to 50% group;
Q3 is occupied by journals in the 50 to 75% group;
Q4 is occupied by journals in the 75 to 100% group.
NOTE: The filter jcrYear is mandatory while using jciQuartile filter
Multiple values are allowed, separated by a semicolon ( ; )
- JCI Percentile
Filter by Journal Citation Indicator (JCI) percentile, ranging from 0 to 100
NOTE: The filter jcrYear is mandatory while using jciPercentile filter
Filter logic is described in the section Filter by range
- Page
- Specifying a page to retrieve
- Limit
- Number of returned results, ranging from 1 to 50
- Result Format
Specify how the response should be mapped to the table output. The following formats are available:
Raw Response: Returns the raw response in a single row with the following columns:
- body: Response body
- status: HTTP status code
