Elsevier SciVal API
The SciVal API gives access to a comprehensive set of metrics for researchers (Scopus Author profiles) and 8,500+ institutions available in SciVal, Elsevier's platform for research performance benchmarking.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/elsevier-scival-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
{
"swagger": "2.0",
"info": {
"title": "Elsevier SciVal APIs",
"version": "3.0.1"
},
"host": "api.elsevier.com",
"basePath": "/analytics/scival",
"schemes": [
"https"
],
"paths": {
"/author/institutionId/{institutionId}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "SciVal institution id of requested authors",
"format": "int64",
"in": "path",
"name": "institutionId",
"required": true,
"type": "integer",
"x-example": 508175
},
{
"default": "5yrs",
"description": "Year range of returned authors",
"enum": [
"3yrs",
"3yrsAndCurrent",
"3yrsAndCurrentAndFuture",
"5yrs",
"5yrsAndCurrent",
"5yrsAndCurrentAndFuture",
"10yrs"
],
"in": "query",
"name": "yearRange",
"type": "string"
},
{
"default": 100,
"description": "The number of authors to return",
"format": "int32",
"in": "query",
"name": "limit",
"type": "integer"
},
{
"default": 0,
"description": "For paginating results, this is how many pages of authors to skip before returning results",
"format": "int32",
"in": "query",
"name": "offset",
"type": "integer"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/AuthorsResponse"
}
},
"400": {
"description": "The offset for this request must be greater than zero"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Author Lookup API"
],
"description": "a maximum of 500 authors are available per institution, sorted by the author's scholarly output in descending order",
"operationId": "getAuthorsByInstitutionId",
"summary": "Get authors by SciVal institution id"
}
},
"/author/metrics": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Types of the desired metrics",
"enum": [
"AcademicCorporateCollaboration",
"AcademicCorporateCollaborationImpact",
"Collaboration",
"CitationCount",
"CitationsPerPublication",
"CitingPatentCount",
"CollaborationImpact",
"CitedPublications",
"FieldWeightedCitationImpact",
"HIndices",
"ScholarlyOutput",
"PatentCitationCount",
"PatentCitationsPerPublication",
"PatentCitedPublicationCount",
"PublicationsInTopJournalPercentiles",
"OutputsInTopCitationPercentiles",
"ViewsPerPublication"
],
"in": "query",
"name": "metricTypes",
"required": true,
"type": "string"
},
{
"description": "Author ids to return metrics for",
"in": "query",
"name": "authors",
"required": true,
"type": "string",
"x-example": "6701858763,20433296900"
},
{
"default": "5yrs",
"description": "Year range of returned metric (see response values for metricStartYear and metricEndYear for actual years)",
"enum": [
"3yrs",
"3yrsAndCurrent",
"3yrsAndCurrentAndFuture",
"5yrs",
"5yrsAndCurrent",
"5yrsAndCurrentAndFuture",
"10yrs"
],
"in": "query",
"name": "yearRange",
"type": "string"
},
{
"default": "",
"description": "The URI(s) of the subject area(s) to filter the returned metrics by. Provide multiple URIs as a comma-separated list; results use OR logic (a publication matches if it belongs to any selected subject area).",
"in": "query",
"name": "subjectAreaFilterURI",
"type": "string"
},
{
"default": true,
"description": "Whether to include self-cited documents (not applicable to all metrics)",
"in": "query",
"name": "includeSelfCitations",
"type": "boolean"
},
{
"default": true,
"description": "Whether to return results broken down by year (not applicable to all metrics)",
"in": "query",
"name": "byYear",
"type": "boolean"
},
{
"default": "AllPublicationTypes",
"description": "Publication types to include (not applicable to all metrics)",
"enum": [
"AllPublicationTypes",
"ArticlesOnly",
"ArticlesReviews",
"ArticlesReviewsConferencePapers",
"ArticlesReviewsConferencePapersBooksAndBookChapters",
"ArticlesConferencePapers",
"BooksAndBookChapters"
],
"in": "query",
"name": "includedDocs",
"type": "string"
},
{
"default": "CiteScore",
"description": "Desired journal impact type (not applicable to all metrics)",
"enum": [
"CiteScore",
"SNIP",
"SJR"
],
"in": "query",
"name": "journalImpactType",
"type": "string"
},
{
"default": false,
"description": "Whether to show results as field-weighted (not applicable to all metrics)",
"in": "query",
"name": "showAsFieldWeighted",
"type": "boolean"
},
{
"default": "hIndex",
"description": "Desired citation impact type (not applicable to all metrics)",
"enum": [
"hIndex",
"h5Index",
"gIndex",
"mIndex"
],
"in": "query",
"name": "indexType",
"type": "string"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/MetricResponse"
}
},
"400": {
"description": "No entities specified"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Author Lookup API"
],
"operationId": "authorMetrics",
"summary": "Get author metrics by id(s)"
}
},
"/author/orcid/{orcid}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "ORCiD of requested author",
"in": "path",
"name": "orcid",
"required": true,
"type": "string",
"x-example": "0000-0001-6031-4923"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/AuthorResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "Author not found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Author Lookup API"
],
"operationId": "getAuthorByORCID",
"summary": "Get an author by ORCiD"
}
},
"/author/{id}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Id of requested author",
"format": "int64",
"in": "path",
"name": "id",
"required": true,
"type": "integer",
"x-example": 6701858763
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/AuthorResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "Author not found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Author Lookup API"
],
"operationId": "getAuthor",
"summary": "Get an author by id"
}
},
"/country/code/{code}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Code of requested country",
"in": "path",
"name": "code",
"required": true,
"type": "string",
"x-example": "AUS"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/CountryResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "Country not found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Lookup API V1"
],
"operationId": "getCountryByCode",
"summary": "Get a country by code"
}
},
"/country/metrics": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Types of the desired metrics",
"enum": [
"AcademicCorporateCollaboration",
"AcademicCorporateCollaborationImpact",
"Collaboration",
"CitationCount",
"CitationsPerPublication",
"CitingPatentCount",
"CollaborationImpact",
"CitedPublications",
"FieldWeightedCitationImpact",
"HIndices",
"ScholarlyOutput",
"PatentCitationCount",
"PatentCitationsPerPublication",
"PatentCitedPublicationCount",
"PublicationsInTopJournalPercentiles",
"OutputsInTopCitationPercentiles"
],
"in": "query",
"name": "metricTypes",
"required": true,
"type": "string"
},
{
"description": "Country ids to return metrics for",
"in": "query",
"name": "countryIds",
"required": true,
"type": "string",
"x-example": "36,42"
},
{
"default": "5yrs",
"description": "Year range of returned metric (see response values for metricStartYear and metricEndYear for actual years)",
"enum": [
"3yrs",
"3yrsAndCurrent",
"3yrsAndCurrentAndFuture",
"5yrs",
"5yrsAndCurrent",
"5yrsAndCurrentAndFuture",
"10yrs"
],
"in": "query",
"name": "yearRange",
"type": "string"
},
{
"default": "",
"description": "The URI(s) of the subject area(s) to filter the returned metrics by. Provide multiple URIs as a comma-separated list; results use OR logic (a publication matches if it belongs to any selected subject area).",
"in": "query",
"name": "subjectAreaFilterURI",
"type": "string"
},
{
"default": true,
"description": "Whether to include self-cited documents (not applicable to all metrics)",
"in": "query",
"name": "includeSelfCitations",
"type": "boolean"
},
{
"default": true,
"description": "Whether to return results broken down by year (not applicable to all metrics)",
"in": "query",
"name": "byYear",
"type": "boolean"
},
{
"default": "AllPublicationTypes",
"description": "Publication types to include (not applicable to all metrics)",
"enum": [
"AllPublicationTypes",
"ArticlesOnly",
"ArticlesReviews",
"ArticlesReviewsConferencePapers",
"ArticlesReviewsConferencePapersBooksAndBookChapters",
"ArticlesConferencePapers",
"BooksAndBookChapters"
],
"in": "query",
"name": "includedDocs",
"type": "string"
},
{
"default": "CiteScore",
"description": "Desired journal impact type (not applicable to all metrics)",
"enum": [
"CiteScore",
"SNIP",
"SJR"
],
"in": "query",
"name": "journalImpactType",
"type": "string"
},
{
"default": false,
"description": "Whether to show results as field-weighted (not applicable to all metrics)",
"in": "query",
"name": "showAsFieldWeighted",
"type": "boolean"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/MetricResponse"
}
},
"400": {
"description": "No entities specified"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Lookup API V1"
],
"operationId": "countryMetrics",
"summary": "Get country metrics by id(s)"
}
},
"/country/search": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Search query string. Valid fields are name, region, and code. Valid operators are OR and AND.",
"in": "query",
"name": "query",
"required": true,
"type": "string",
"x-example": "name(brazil)"
},
{
"default": 100,
"description": "The number of results to return",
"format": "int32",
"in": "query",
"name": "limit",
"type": "integer"
},
{
"default": 0,
"description": "For paginating results, this is how many pages of results to skip before returning results",
"format": "int32",
"in": "query",
"name": "offset",
"type": "integer"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/CountrySearchResponse"
}
},
"400": {
"description": "Query not specified"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Lookup API V1"
],
"description": "sorted alphabetically by name in ascending order",
"operationId": "countrySearch",
"summary": "Find countries by name, region, or region code"
}
},
"/country/{id}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Id of requested country",
"format": "int64",
"in": "path",
"name": "id",
"required": true,
"type": "integer",
"x-example": 36
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/CountryResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "Country not found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Lookup API V1"
],
"operationId": "getCountry",
"summary": "Get a country by id"
}
},
"/countryGroup/metrics": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Types of the desired metrics",
"enum": [
"AcademicCorporateCollaboration",
"AcademicCorporateCollaborationImpact",
"Collaboration",
"CitationCount",
"CitationsPerPublication",
"CitingPatentCount",
"CollaborationImpact",
"CitedPublications",
"FieldWeightedCitationImpact",
"HIndices",
"ScholarlyOutput",
"PatentCitationCount",
"PatentCitationsPerPublication",
"PatentCitedPublicationCount",
"PublicationsInTopJournalPercentiles",
"OutputsInTopCitationPercentiles"
],
"in": "query",
"name": "metricTypes",
"required": true,
"type": "string"
},
{
"description": "Country group ids to return metrics for",
"in": "query",
"name": "countryGroupIds",
"required": true,
"type": "string",
"x-example": "2,3"
},
{
"default": "5yrs",
"description": "Year range of returned metric (see response values for metricStartYear and metricEndYear for actual years)",
"enum": [
"3yrs",
"3yrsAndCurrent",
"3yrsAndCurrentAndFuture",
"5yrs",
"5yrsAndCurrent",
"5yrsAndCurrentAndFuture",
"10yrs"
],
"in": "query",
"name": "yearRange",
"type": "string"
},
{
"default": "",
"description": "The URI(s) of the subject area(s) to filter the returned metrics by. Provide multiple URIs as a comma-separated list; results use OR logic (a publication matches if it belongs to any selected subject area).",
"in": "query",
"name": "subjectAreaFilterURI",
"type": "string"
},
{
"default": true,
"description": "Whether to include self-cited documents (not applicable to all metrics)",
"in": "query",
"name": "includeSelfCitations",
"type": "boolean"
},
{
"default": true,
"description": "Whether to return results broken down by year (not applicable to all metrics)",
"in": "query",
"name": "byYear",
"type": "boolean"
},
{
"default": "AllPublicationTypes",
"description": "Publication types to include (not applicable to all metrics)",
"enum": [
"AllPublicationTypes",
"ArticlesOnly",
"ArticlesReviews",
"ArticlesReviewsConferencePapers",
"ArticlesReviewsConferencePapersBooksAndBookChapters",
"ArticlesConferencePapers",
"BooksAndBookChapters"
],
"in": "query",
"name": "includedDocs",
"type": "string"
},
{
"default": "CiteScore",
"description": "Desired journal impact type (not applicable to all metrics)",
"enum": [
"CiteScore",
"SNIP",
"SJR"
],
"in": "query",
"name": "journalImpactType",
"type": "string"
},
{
"default": false,
"description": "Whether to show results as field-weighted (not applicable to all metrics)",
"in": "query",
"name": "showAsFieldWeighted",
"type": "boolean"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/MetricResponse"
}
},
"400": {
"description": "No entities specified"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Group Lookup API V1"
],
"operationId": "countryGroupMetricsV1",
"summary": "Get country group metrics by id(s)"
}
},
"/countryGroup/search": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Search query string. Valid fields are name, category, country, countryId, and code. Valid operators are OR and AND.",
"in": "query",
"name": "query",
"required": true,
"type": "string",
"x-example": "name(europe)"
},
{
"default": 100,
"description": "The number of results to return",
"format": "int32",
"in": "query",
"name": "limit",
"type": "integer"
},
{
"default": 0,
"description": "For paginating results, this is how many pages of results to skip before returning results",
"format": "int32",
"in": "query",
"name": "offset",
"type": "integer"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/CountryGroupSearchResponse"
}
},
"400": {
"description": "Query not specified"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Group Lookup API V1"
],
"description": "sorted alphabetically by name in ascending order",
"operationId": "countryGroupSearchV1",
"summary": "Find country groups by name, category, or child country"
}
},
"/countryGroup/{id}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "Id of requested country group",
"format": "int64",
"in": "path",
"name": "id",
"required": true,
"type": "integer",
"x-example": 3
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/CountryGroupResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "Country group not found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Country Group Lookup API V1"
],
"operationId": "getCountryGroup",
"summary": "Get an country group by id"
}
},
"/institution": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"default": 100,
"description": "The number of results to return",
"format": "int32",
"in": "query",
"name": "limit",
"type": "integer"
},
{
"default": 0,
"description": "For paginating results, this is how many pages of results to skip before returning results",
"format": "int32",
"in": "query",
"name": "offset",
"type": "integer"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/InstitutionsResponse"
}
},
"401": {
"description": "Request not authorized"
},
"404": {
"description": "No institutions were found"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Institution Lookup API V1"
],
"description": "sorted alphabetically by name in ascending order",
"operationId": "getInstitutions",
"summary": "Get all institutions"
}
},
"/institution/count": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/InstitutionCountResponse"
}
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Institution Lookup API V1"
],
"operationId": "institutionCount",
"summary": "Get the number of institutions in SciVal"
}
},
"/institution/countryGroupId/{countryGroupId}": {
"get": {
"produces": [
"application/json",
"application/xml",
"text/xml"
],
"parameters": [
{
"description": "SciVal country group id of requested institutions",
"format": "int64",
"in": "path",
"name": "countryGroupId",
"required": true,
"type": "integer",
"x-example": 3
},
{
"default": "5yrs",
"description": "Year range of returned institutions",
"enum": [
"3yrs",
"3yrsAndCurrent",
"3yrsAndCurrentAndFuture",
"5yrs",
"5yrsAndCurrent",
"5yrsAndCurrentAndFuture",
"10yrs"
],
"in": "query",
"name": "yearRange",
"type": "string"
},
{
"default": 100,
"description": "The number of institutions to return",
"format": "int32",
"in": "query",
"name": "limit",
"type": "integer"
},
{
"default": 0,
"description": "For paginating results, this is how many pages of institutions to skip before returning results",
"format": "int32",
"in": "query",
"name": "offset",
"type": "integer"
},
{
"default": "7f59af901d2d86f78a1fd60c1bf9426a",
"description": "Your API key",
"in": "query",
"name": "apiKey",
"required": true,
"type": "string"
},
{
"description": "Specification for authorization, institution authtoken",
"in": "query",
"name": "insttoken",
"required": false,
"type": "string"
},
{
"description": "Specification for active session, secured authtoken",
"in": "query",
"name": "access_token",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"$ref": "#/definitions/InstitutionsResponse"
}
},
"400": {
"description": "The offset for this request must be greater than zero"
},
"401": {
"description": "Request not authorized"
},
"500": {
"description": "Unknown error encountered"
}
},
"tags": [
"SciVal Institution Lookup API V1"
],
"description": "sorted by the institution's scholarly output in descending order",
"operationId": "getInstitutionsByC
# --- truncated at 32 KB (168 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/elsevier/refs/heads/main/openapi/elsevier-scival-swagger.json