API / Документация

AkademBase API

REST, JSON и аутентификация по API-ключу через заголовок. Ниже: группы эндпоинтов, аутентификация и правила использования.

Начало работы

AkademBase API основан на REST, возвращает JSON и аутентифицируется по Bearer-ключу. Ниже — базовый URL, аутентификация, пагинация, ошибки и справочник эндпоинтов.

Все запросы принимают и возвращают JSON. Для POST-запросов отправляйте Content-Type: application/json.

Базовый URLhttps://api.akadembase.org

Этот интерактивный справочник генерируется из «живой» спецификации OpenAPI, охватывающей 19 публичных эндпоинтов чтения. Концептуальное руководство — аутентификация, пагинация, ошибки и лимиты запросов — см. в документации API.

Справочник OpenAPI Скачать спецификацию OpenAPI (JSON)

Технический контент: Имена эндпоинтов, параметров, поля JSON и строки ABI остаются английскими во всех локалях.

Аутентификация

Каждый запрос /v1/* требует Bearer-ключ в заголовке Authorization. Ключ выдаётся по запросу — см. страницу Access.

bash

curl "https://api.akadembase.org/v1/works/{abi}" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Храните ключ на сервере и направляйте запросы через собственный server-side proxy — ключ не должен попадать в браузер (клиент).

Пагинация

Существуют две модели пагинации — в зависимости от эндпоинта.

Списочные (list) эндпоинты: Используют page и per_page (по умолчанию 25, максимум 200). meta.count — общее число; для глубокой пагинации передавайте meta.next_cursor как cursor в следующем запросе.
Поиск (search): POST /v1/search работает иначе — через offset и limit, в ответе возвращается total.

Ошибки

Ошибки возвращаются со стандартными кодами HTTP. Есть две формы JSON: RFC 7807 (problem+json) и подробная форма для валидации параметров.

`400`	`Bad Request`	Некорректный ABI или неизвестное поле filter.
`401`	`Unauthorized`	Ключ отсутствует или недействителен.
`404`	`Not Found`	Корректный по форме, но несуществующий ABI.
`422`	`Validation Error`	Недопустимое значение параметра (например, per_page > 200).
`429`	`Too Many Requests`	Превышен лимит запросов — выполните back off.

404 — RFC 7807

{
  "type": "about:blank",
  "title": "Work not found",
  "status": 404,
  "detail": null,
  "instance": "ABI:AkademIndex/openalex/2099.article.999999"
}

422 — validation

{
  "type": "about:blank",
  "title": "Validation error",
  "status": 422,
  "detail": "[{'type': 'less_than_equal', 'loc': ('query', 'per_page'), 'msg': 'Input should be less than or equal to 200'}]"
}

Некоторые ответы 400 содержат подсказку — например, при неизвестном поле filter возвращается список допустимых полей.

Лимиты запросов

Для стабильной работы с API следуйте трём простым правилам:

Кэшируйте: Кэшируйте ответы — не отправляйте один и тот же запрос повторно.
Идентифицируйтесь: Отправляйте понятный User-Agent и контактные данные.
Снижайте темп: При 429 (Too Many Requests) подождите и повторите попытку позже.

Лимиты по тарифам: Академический (бесплатно) и Partner (платно). Векторные / семантические вызовы учитываются в отдельной квоте. Точные цифры будут опубликованы позже.

Эндпоинты

Search

Ключевой, семантический и гибридный поиск — флагманский эндпоинт. Вместе с результатами возвращаются фасеты по отфильтрованному набору.

POST/v1/search

Поиск

Ищет по документам и возвращает результаты с фасетами. Фильтры одиночные (single-valued): каждое поле фильтра принимает одно значение. Объект facets вычисляется по каждому измерению над отфильтрованным набором.

Параметры

Имя	Где	Тип	Описание
`query`обязателен	`body`	`string`	Поисковый запрос.
`limit`необязателен	`body`	`integer`default: `10`	Число возвращаемых результатов.
`offset`необязателен	`body`	`integer`default: `0`	Смещение для пагинации.
`year`необязателен	`body`	`integer`	Фильтр по году публикации.
`type`необязателен	`body`	`string`	Тип документа (например article, chapter).
`source`необязателен	`body`	`string`	Фильтр по ABI источника.
`topic`необязателен	`body`	`string`	Фильтр по ABI темы.
`language`необязателен	`body`	`string`	Фильтр по языку документа (соответствует фасету).
`lang`необязателен	`body`	`string`	Необязательное языковое предпочтение; в отличие от language, не фильтрует, какие документы попадают в выборку.
`country`необязателен	`body`	`string`	Фильтр по коду страны.

Тело запроса (request body)

JSON

{"query":"education","limit":10,"year":2023,"type":"article","language":"en"}

Пример ответа

JSON

{
  "query": "education",
  "total": 94,
  "offset": 0,
  "limit": 2,
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/2025.article.012658",
      "title": { "en": "THE IMPORTANCE OF EDUCATION" },
      "score": 0.0164,
      "dense_rank": 1,
      "fts_rank": null,
      "year": 2025,
      "type": "article",
      "source": {
        "source_abi": "ABI:AkademScholar/sources/2026.source.007923",
        "name": { "und": "Zenodo (CERN ...)" },
        "type": "repository"
      },
      "authors": [
        {
          "author_abi": "ABI:AkademID/researchers/2025.author.030639",
          "display_name": { "en": "Gafurova Marjona Ashrapovna" },
          "position": 1,
          "role": "author",
          "affiliation": "Kimyo International University in Tashkent"
        }
      ],
      "topics": [
        {
          "topic_abi": "ABI:AkademScholar/topics/2026.topic.004587",
          "name": { "en": "Educational Challenges and Innovations" },
          "score": 0.0131,
          "is_primary": true
        }
      ],
      "snippet": null,
      "cited_by_count": 0
    }
  ],
  "facets": {
    "year": [{ "key": 2021, "key_display_name": "2021", "count": 24 }],
    "type": [{ "key": "article", "key_display_name": "article", "count": 86 }],
    "source": [{ "key": "ABI:AkademScholar/sources/2026.source.007923", "key_display_name": { "und": "Zenodo (CERN ...)" }, "count": 41 }],
    "topic": [{ "key": "ABI:AkademScholar/topics/2026.topic.004587", "key_display_name": { "en": "Educational Challenges and Innovations" }, "count": 12 }],
    "language": [{ "key": "en", "key_display_name": "en", "count": 70 }],
    "country": [{ "key": "UZ", "key_display_name": "UZ", "count": 58 }]
  }
}

curl -X POST "https://api.akadembase.org/v1/search" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"education","limit":10,"year":2023,"type":"article","language":"en"}'

facets возвращаются по измерениям year, type, source, topic, language, country. Каждый bucket: key, key_display_name, count.

Works

Документы (works) — полные метаданные, авторы, источник, темы и цитатные связи.

GET/v1/works/{abi}

Один документ

Полная запись одного документа (DocumentRead): авторы, источник, темы, внешние ID, cited_by_count и reference_count.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI документа.

Пример ответа

JSON

{
  "abi": "ABI:AkademIndex/openalex/2025.article.012658",
  "type": "article",
  "title": { "en": "THE IMPORTANCE OF EDUCATION" },
  "abstract": null,
  "language": null,
  "year": 2025,
  "doi": "10.5281/zenodo.17640942",
  "isbn": null,
  "issn": null,
  "source_id": 29910,
  "pages": null,
  "genre": null,
  "full_text_level": "none",
  "license": null,
  "pdf_url": null,
  "version": 1,
  "external_ids": { "openalex": "W7105998667" },
  "record_origin": "core",
  "record_level": "full",
  "cited_by_count": 0,
  "reference_count": 0,
  "authors": [
    {
      "author_abi": "ABI:AkademID/researchers/2025.author.030639",
      "display_name": { "en": "Gafurova Marjona Ashrapovna" },
      "position": 1,
      "role": "author",
      "affiliation": "Kimyo International University in Tashkent"
    }
  ],
  "source": {
    "source_abi": "ABI:AkademScholar/sources/2026.source.007923",
    "name": { "und": "Zenodo (CERN ...)" },
    "type": "repository"
  },
  "topics": [
    {
      "topic_abi": "ABI:AkademScholar/topics/2026.topic.004587",
      "name": { "en": "Educational Challenges and Innovations" },
      "score": 0.0131,
      "is_primary": true
    }
  ],
  "requested_abi": "ABI:AkademIndex/openalex/2025.article.012658",
  "canonical_abi": "ABI:AkademIndex/openalex/2025.article.012658"
}

curl "https://api.akadembase.org/v1/works/ABI%3AAkademIndex%2Fopenalex%2F2025.article.012658" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Строка ABI содержит символы : и /, поэтому в пути её нужно URL-кодировать (: → %3A, / → %2F).

GET/v1/works

Список документов

Возвращает документы постранично (WorksListResponse). С помощью filter и sort можно строить мощные запросы.

Параметры

Имя	Где	Тип	Описание
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": {
    "count": 212186,
    "db_response_time_ms": 38,
    "page": 1,
    "per_page": 25,
    "next_cursor": null
  },
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/2023.article.000007",
      "type": "article",
      "title": { "en": "..." },
      "year": 2023,
      "doi": "10.xxxx/...",
      "cited_by_count": 148,
      "reference_count": 1,
      "authors": [{ "author_abi": "ABI:AkademID/researchers/...", "display_name": { "en": "..." }, "position": 1, "role": "author", "affiliation": "..." }],
      "source": { "source_abi": "ABI:AkademScholar/sources/...", "name": { "und": "..." }, "type": "journal" },
      "topics": [{ "topic_abi": "ABI:AkademScholar/topics/...", "name": { "en": "..." }, "score": 0.02, "is_primary": true }]
    }
  ]
}

curl "https://api.akadembase.org/v1/works?filter=year:2023,type:article&sort=cited_by_count:desc&per_page=25" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Поля filter: cited_by, cites, year, type, source, topic, language, authorships.author, institutions.country_code, doi, record_origin. sort поддерживает cited_by_count:desc. Внимание: cited_by_count сортируется, но не фильтруется.

GET/v1/works/{abi}/citations

Цитирования (входящие)

Документы, цитирующие этот документ — входящие цитирования. meta.count = cited_by_count.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI документа.
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": {
    "count": 99,
    "db_response_time_ms": 21,
    "page": 1,
    "per_page": 25,
    "next_cursor": null
  },
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/...",
      "type": "article",
      "title": { "en": "..." },
      "year": 2024,
      "cited_by_count": 3,
      "authors": [{ "author_abi": "ABI:AkademID/researchers/...", "display_name": { "en": "..." }, "position": 1, "role": "author", "affiliation": "..." }]
    }
  ]
}

curl "https://api.akadembase.org/v1/works/ABI%3AAkademIndex%2Fopenalex%2F2023.article.000020/citations" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Обратите внимание на направление: /citations — КТО цитирует этот документ (входящие); /references — на КОГО ссылается этот документ (исходящие).

GET/v1/works/{abi}/references

Ссылки (исходящие)

Документы, на которые ссылается этот документ — исходящие ссылки. meta.count = reference_count.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI документа.
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": {
    "count": 20,
    "db_response_time_ms": 9,
    "page": 1,
    "per_page": 25,
    "next_cursor": null
  },
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/...",
      "type": "article",
      "title": { "en": "..." },
      "year": 2019,
      "cited_by_count": 412,
      "authors": [{ "author_abi": "ABI:AkademID/researchers/...", "display_name": { "en": "..." }, "position": 1, "role": "author", "affiliation": "..." }]
    }
  ]
}

curl "https://api.akadembase.org/v1/works/ABI%3AAkademIndex%2Fopenalex%2F2023.article.000020/references" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Authors

Авторы — метаданные профиля и их работы.

GET/v1/authors/{abi}

Один автор

Профиль автора: display_name, name_variants, orcid, last_known_institution, works_count, cited_by_count, h_index, i10_index.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI автора.

Пример ответа

JSON

{
  "abi": "ABI:AkademID/researchers/2025.author.030639",
  "display_name": { "en": "Gafurova Marjona Ashrapovna" },
  "name_variants": ["Gafurova Marjona Ashrapovna"],
  "orcid": null,
  "last_known_institution": "ABI:AkademScholar/orgs/2026.org.001832",
  "specialty": null,
  "works_count": 2,
  "cited_by_count": 0,
  "h_index": 0,
  "i10_index": 0,
  "requested_abi": "ABI:AkademID/researchers/2025.author.030639",
  "canonical_abi": "ABI:AkademID/researchers/2025.author.030639"
}

curl "https://api.akadembase.org/v1/authors/ABI%3AAkademID%2Fresearchers%2F2025.author.030639" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Строка ABI содержит символы : и /, поэтому в пути её нужно URL-кодировать (: → %3A, / → %2F).

GET/v1/authors/{abi}/works

Работы автора

Работы автора (WorksListResponse). Поддерживаются все списочные параметры.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI автора.
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": {
    "count": 212186,
    "db_response_time_ms": 38,
    "page": 1,
    "per_page": 25,
    "next_cursor": null
  },
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/2023.article.000007",
      "type": "article",
      "title": { "en": "..." },
      "year": 2023,
      "doi": "10.xxxx/...",
      "cited_by_count": 148,
      "reference_count": 1,
      "authors": [{ "author_abi": "ABI:AkademID/researchers/...", "display_name": { "en": "..." }, "position": 1, "role": "author", "affiliation": "..." }],
      "source": { "source_abi": "ABI:AkademScholar/sources/...", "name": { "und": "..." }, "type": "journal" },
      "topics": [{ "topic_abi": "ABI:AkademScholar/topics/...", "name": { "en": "..." }, "score": 0.02, "is_primary": true }]
    }
  ]
}

curl "https://api.akadembase.org/v1/authors/ABI%3AAkademID%2Fresearchers%2F2025.author.030639/works" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

GET/v1/authors

Список авторов

Возвращает авторов постранично. Поддерживаются filter, sort и прочие списочные параметры.

Параметры

Имя	Где	Тип	Описание
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": { "count": 809254, "db_response_time_ms": 424, "page": 1, "per_page": 25, "next_cursor": null },
  "results": [
    {
      "abi": "ABI:AkademID/researchers/2016.author.000081",
      "display_name": { "en": "Ahmadjon Abdujabbarov" },
      "name_variants": ["Ahmadjon Abdujabbarov"],
      "orcid": "0000-0002-6686-3787",
      "last_known_institution": "ABI:AkademScholar/orgs/2026.org.000575",
      "specialty": null,
      "works_count": 236,
      "cited_by_count": 3441,
      "h_index": 33,
      "i10_index": 108
    }
  ]
}

curl "https://api.akadembase.org/v1/authors?sort=cited_by_count:desc&per_page=25" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Topics

Темы — иерархическая классификация (level, parent) и работы по теме.

GET/v1/topics/{abi}

Одна тема

Профиль темы: display_name, level, parent, works_count, cited_by_count.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI темы.

Пример ответа

JSON

{
  "abi": "ABI:AkademScholar/topics/2026.topic.004587",
  "display_name": { "en": "Educational Challenges and Innovations" },
  "level": "topic",
  "parent": "ABI:AkademScholar/topics/2026.topic.000186",
  "description": null,
  "works_count": 156,
  "cited_by_count": 18,
  "requested_abi": "ABI:AkademScholar/topics/2026.topic.004587",
  "canonical_abi": "ABI:AkademScholar/topics/2026.topic.004587"
}

curl "https://api.akadembase.org/v1/topics/ABI%3AAkademScholar%2Ftopics%2F2026.topic.004587" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Строка ABI содержит символы : и /, поэтому в пути её нужно URL-кодировать (: → %3A, / → %2F).

GET/v1/topics/{abi}/works

Работы по теме

Документы, относящиеся к этой теме (WorksListResponse).

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI темы.
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": {
    "count": 212186,
    "db_response_time_ms": 38,
    "page": 1,
    "per_page": 25,
    "next_cursor": null
  },
  "results": [
    {
      "abi": "ABI:AkademIndex/openalex/2023.article.000007",
      "type": "article",
      "title": { "en": "..." },
      "year": 2023,
      "doi": "10.xxxx/...",
      "cited_by_count": 148,
      "reference_count": 1,
      "authors": [{ "author_abi": "ABI:AkademID/researchers/...", "display_name": { "en": "..." }, "position": 1, "role": "author", "affiliation": "..." }],
      "source": { "source_abi": "ABI:AkademScholar/sources/...", "name": { "und": "..." }, "type": "journal" },
      "topics": [{ "topic_abi": "ABI:AkademScholar/topics/...", "name": { "en": "..." }, "score": 0.02, "is_primary": true }]
    }
  ]
}

curl "https://api.akadembase.org/v1/topics/ABI%3AAkademScholar%2Ftopics%2F2026.topic.004587/works" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

GET/v1/topics

Список тем

Возвращает темы постранично. Поддерживаются filter, sort и прочие списочные параметры.

Параметры

Имя	Где	Тип	Описание
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": { "count": 4700, "db_response_time_ms": 9, "page": 1, "per_page": 25, "next_cursor": null },
  "results": [
    {
      "abi": "ABI:AkademScholar/topics/2026.topic.002968",
      "display_name": { "en": "Engineering and Agricultural Innovations" },
      "level": "topic",
      "parent": "ABI:AkademScholar/topics/2026.topic.000620",
      "description": null,
      "works_count": 22871,
      "cited_by_count": 15591
    }
  ]
}

curl "https://api.akadembase.org/v1/topics?sort=works_count:desc&per_page=25" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Sources

Источники — метаданные журналов, репозиториев и издателей.

GET/v1/sources/{abi}

Один источник

Профиль источника: display_name, type, issn_l, publisher, country_code, works_count, cited_by_count, h_index.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI источника.

Пример ответа

JSON

{
  "abi": "ABI:AkademScholar/sources/2026.source.007923",
  "display_name": { "und": "Zenodo (CERN European Organization for Nuclear Research)" },
  "code": null,
  "issn_l": null,
  "issns": null,
  "type": "repository",
  "publisher": null,
  "country_code": null,
  "host_organization": null,
  "oak_listed": false,
  "doaj": false,
  "works_count": 82034,
  "cited_by_count": 694,
  "h_index": 8,
  "mean_citedness_2yr": 0.00021,
  "requested_abi": "ABI:AkademScholar/sources/2026.source.007923",
  "canonical_abi": "ABI:AkademScholar/sources/2026.source.007923"
}

curl "https://api.akadembase.org/v1/sources/ABI%3AAkademScholar%2Fsources%2F2026.source.007923" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Отдельного /works для источника нет. Документы источника получайте через GET /v1/works?filter=source:{abi}.

GET/v1/sources

Список источников

Возвращает источники постранично. Поддерживаются filter, sort и прочие списочные параметры.

Параметры

Имя	Где	Тип	Описание
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": { "count": 10994, "db_response_time_ms": 13, "page": 1, "per_page": 25, "next_cursor": null },
  "results": [
    {
      "abi": "ABI:AkademScholar/sources/2026.source.005024",
      "display_name": { "und": "E3S Web of Conferences" },
      "issn_l": "2267-1242",
      "issns": ["2267-1242", "2555-0403"],
      "type": "journal",
      "publisher": null,
      "country_code": null,
      "oak_listed": false,
      "doaj": false,
      "works_count": 4578,
      "cited_by_count": 17522,
      "h_index": 37,
      "mean_citedness_2yr": 0.1875
    }
  ]
}

curl "https://api.akadembase.org/v1/sources?sort=works_count:desc&per_page=25" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Institutions

Организации — метаданные университетов и научных учреждений.

GET/v1/institutions/{abi}

Одна организация

Профиль организации: display_name, aliases, ror, country_code, status, works_count, author_count, cited_by_count, h_index.

Параметры

Имя	Где	Тип	Описание
`abi`обязателен	`path`	`string`	ABI организации.

Пример ответа

JSON

{
  "abi": "ABI:AkademScholar/orgs/2026.org.000226",
  "display_name": {
    "en": "Academy of Sciences Republic of Uzbekistan",
    "ru": "Академия наук Узбекистана",
    "uz_Latn": "Oʻzbekiston Respublikasi Fanlar Akademiyasi"
  },
  "aliases": ["Academy of Sciences Republic of Uzbekistan", "UzAS"],
  "ror": "https://ror.org/01xgfaw76",
  "country_code": "UZ",
  "type": null,
  "status": "active",
  "parent_institution": null,
  "works_count": 11817,
  "author_count": 8096,
  "cited_by_count": 20609,
  "h_index": 31,
  "requested_abi": "ABI:AkademScholar/orgs/2026.org.000226",
  "canonical_abi": "ABI:AkademScholar/orgs/2026.org.000226"
}

curl "https://api.akadembase.org/v1/institutions/ABI%3AAkademScholar%2Forgs%2F2026.org.000226" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Отдельного /works для организации нет. Документы получайте через фильтры вида GET /v1/works?filter=institutions.country_code:{code}.

GET/v1/institutions

Список организаций

Возвращает организации постранично. Поддерживаются filter, sort и прочие списочные параметры.

Параметры

Имя	Где	Тип	Описание
`search`необязателен	`query`	`string`	Полнотекстовый поиск внутри коллекции.
`filter`необязателен	`query`	`string`	Фильтр в виде field:value; несколько условий объединяются запятой (AND).
`sort`необязателен	`query`	`string`	Сортировка в виде field:desc или field:asc.
`select`необязателен	`query`	`string`	Список полей через запятую — чтобы сузить ответ.
`group_by`необязателен	`query`	`string`	Группировка результатов по полю (агрегация).
`page`необязателен	`query`	`integer`default: `1`	Номер страницы, начиная с 1.
`per_page`необязателен	`query`	`integer`default: `25`	Число записей на странице (максимум 200).
`cursor`необязателен	`query`	`string`	Курсор из meta.next_cursor для глубокой пагинации.

Пример ответа

JSON

{
  "meta": { "count": 30882, "db_response_time_ms": 38, "page": 1, "per_page": 25, "next_cursor": null },
  "results": [
    {
      "abi": "ABI:AkademScholar/orgs/2026.org.000226",
      "display_name": { "en": "Academy of Sciences Republic of Uzbekistan", "ru": "Академия наук Узбекистана" },
      "aliases": ["Academy of Sciences Republic of Uzbekistan", "UzAS"],
      "ror": "https://ror.org/01xgfaw76",
      "country_code": "UZ",
      "type": null,
      "status": "active",
      "parent_institution": null,
      "works_count": 11817,
      "author_count": 8096,
      "cited_by_count": 20609,
      "h_index": 31
    }
  ]
}

curl "https://api.akadembase.org/v1/institutions?sort=works_count:desc&per_page=25" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Autocomplete

Быстрый префиксный поиск (typeahead) — по всем сущностям или внутри одного типа.

GET/v1/autocomplete

Все сущности

Автодополнение по всем типам сущностей. Работает cross-script — совпадают и кириллические, и латинские запросы.

Параметры

Имя	Где	Тип	Описание
`q`обязателен	`query`	`string`	Префикс запроса.
`limit`необязателен	`query`	`integer`default: `10`	Число результатов.

Пример ответа

JSON

{
  "query": "educ",
  "count": 3,
  "results": [
    {
      "id": "ABI:AkademScholar/topics/2026.topic.004158",
      "display_name": "Education, Innovation and Language Studies",
      "hint": "Education",
      "cited_by_count": 3254,
      "works_count": 57253,
      "entity_type": "topic",
      "external_id": "https://openalex.org/T13958"
    },
    {
      "id": "ABI:AkademScholar/orgs/2026.org.002265",
      "display_name": "University of Education",
      "hint": "PK",
      "cited_by_count": 629,
      "works_count": 177,
      "entity_type": "institution",
      "external_id": "https://ror.org/052z7nw84"
    }
  ]
}

curl "https://api.akadembase.org/v1/autocomplete?q=educ&limit=5" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

GET/v1/autocomplete/{entity}

Один тип сущности

Автодополнение внутри одного типа сущности.

Параметры

Имя	Где	Тип	Описание
`entity`обязателен	`path`	`string`	Тип сущности.`authorsinstitutionssourcestopicsworks`
`q`обязателен	`query`	`string`	Префикс запроса.
`limit`необязателен	`query`	`integer`default: `10`	Число результатов.

Пример ответа

JSON

{
  "query": "educ",
  "count": 3,
  "results": [
    {
      "id": "ABI:AkademScholar/topics/2026.topic.004158",
      "display_name": "Education, Innovation and Language Studies",
      "hint": "Education",
      "cited_by_count": 3254,
      "works_count": 57253,
      "entity_type": "topic",
      "external_id": "https://openalex.org/T13958"
    },
    {
      "id": "ABI:AkademScholar/orgs/2026.org.002265",
      "display_name": "University of Education",
      "hint": "PK",
      "cited_by_count": 629,
      "works_count": 177,
      "entity_type": "institution",
      "external_id": "https://ror.org/052z7nw84"
    }
  ]
}

curl "https://api.akadembase.org/v1/autocomplete/authors?q=gafur&limit=5" \
  -H "Authorization: Bearer $AKADEMBASE_API_KEY"

Public stats

Публичные показатели — без аутентификации. Эти эндпоинты не требуют Bearer-ключа.

GET/public/statsАутентификация не требуется

Статистика корпуса

Размер корпуса: число документов и цитирований. Аутентификация не требуется.

Параметры

Без параметров.

Пример ответа

JSON

{
  "documents": 212186,
  "citations": 1368882
}

curl "https://api.akadembase.org/public/stats"

GET/public/activityАутентификация не требуется

Активность использования

Показатели использования: поиски, просмотренные документы, cross-lingual поиски (всего и за 30 дней). Аутентификация не требуется.

Параметры

Без параметров.

Пример ответа

JSON

{
  "searches_total": 65,
  "works_viewed_total": 53,
  "cross_lingual_searches_total": 1,
  "searches_total_30d": 65,
  "works_viewed_total_30d": 53,
  "cross_lingual_searches_total_30d": 1
}

curl "https://api.akadembase.org/public/activity"