API / Ҳужжатлар

AkademBase API

REST, JSON ва header орқали API-key аутентификация. Қуйида endpoint гуруҳлари, аутентификация ва фойдаланиш қоидалари.

Бошлаш

AkademBase API — REST асосида, JSON қайтаради ва Bearer калит билан аутентификация қилинади. Қуйида базавий URL, аутентификация, pagination, хатолар ва endpoint reference.

Барча сўровлар JSON қабул қилади ва қайтаради. POST сўровлар учун Content-Type: application/json юборинг.

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

Ушбу интерактив маълумотнома 19 та очиқ ўқиш endpoint'ини қамраб олувчи жонли OpenAPI спетсификациясидан генерация қилинади. Концептуал қўлланма — аутентификация, pagination, хатолар ва rate limitлар — учун API ҳужжатларига қаранг.

OpenAPI маълумотнома OpenAPI спетсификациясини юклаб олиш (JSON)

Техник контент: Endpoint номлари, параметр номлари, JSON майдонлари ва ABI сатрлари барча тилларда инглизча бўлиб қолади.

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

Ҳар бир /v1/* сўрови Authorization сарлавҳасида Bearer калитни талаб қилади. Калит gated — уни олиш учун Access саҳифасига мурожаат қилинг.

bash

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

Калитни сервер томонда сақланг ва сўровларни ўзингизнинг server-side proxy'ингиз орқали юборинг — калит ҳеч қачон браузерга (клиентга) тушмаслиги керак.

Pagination

Икки хил pagination модели бор — қайси endpoint'га қараб.

Рўйхат (list) endpoint'лар: page ва per_page (default 25, максимум 200) билан саҳифаланади. meta.count — умумий сони; чуқур pagination учун meta.next_cursor қийматини кейинги сўровда cursor сифатида юборинг.
Қидирув (search): POST /v1/search бошқача — offset ва limit билан ишлайди, жавобда total қайтади.

Хатолар

Хатолар стандарт HTTP status кодлари билан қайтади. Икки хил 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`	Rate limit ошиб кетди — 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 майдонида рухсат этилган майдонлар рўйхати қайтади.

Rate limits

API'дан барқарор фойдаланиш учун учта оддий қоидага амал қилинг:

Cache: Жавобларни кешланг — бир хил сўровни қайта юборманг.
Identify yourself: Аниқ User-Agent ва алоқа маълумотини юборинг.
Back off: 429 (Too Many Requests) келганда кутинг ва кейин қайта уриниб кўринг.

Лимитлар tier асосида: Академик (бепул) ва Partner (пуллик). Вектор / семантик чақирувлар алоҳида квота остида ҳисобланади. Аниқ рақамлар кейинроқ эълон қилинади.

Endpoint'лар

Search

Keyword, семантик ва гибрид қидирув — флагман endpoint. Натижалар билан бирга филтрланган тўплам устидаги facet'лар қайтади.

POST/v1/search

Қидирув

Ҳужжатлар бўйлаб қидиради ва facet'лар билан натижа қайтаради. Филтрлар битта қийматли (single-valued): ҳар бир филтр майдони битта қиймат олади. facets объекти ҳар бир ўлчам (dimension) бўйича филтрланган тўплам устида ҳисобланади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`query`мажбурий	`body`	`string`	Қидирув матни.
`limit`ихтиёрий	`body`	`integer`default: `10`	Қайтариладиган натижалар сони.
`offset`ихтиёрий	`body`	`integer`default: `0`	Pagination учун силжиш.
`year`ихтиёрий	`body`	`integer`	Нашр йили бўйича филтр.
`type`ихтиёрий	`body`	`string`	Ҳужжат тури (масалан article, chapter).
`source`ихтиёрий	`body`	`string`	Манба ABI бўйича филтр.
`topic`ихтиёрий	`body`	`string`	Мавзу ABI бўйича филтр.
`language`ихтиёрий	`body`	`string`	Ҳужжат тили бўйича филтр (facet билан мос келади).
`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 сатри : ва / белгиларини ўз ичига олади, шунинг учун уни path'да URL-encode қилинг (: → %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`	Чуқур pagination учун 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`	Чуқур pagination учун 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`	Чуқур pagination учун 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 сатри : ва / белгиларини ўз ичига олади, шунинг учун уни path'да URL-encode қилинг (: → %3A, / → %2F).

GET/v1/authors/{abi}/works

Муаллифнинг ҳужжатлари

Муаллиф чиқарган ҳужжатлар (WorksListResponse). Барча list параметрлари қўлланилади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`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`	Чуқур pagination учун 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 ва бошқа list параметрлари қўлланилади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`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`	Чуқур pagination учун 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 сатри : ва / белгиларини ўз ичига олади, шунинг учун уни path'да URL-encode қилинг (: → %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`	Чуқур pagination учун 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 ва бошқа list параметрлари қўлланилади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`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`	Чуқур pagination учун 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 endpoint'и йўқ. Бир манбадаги ҳужжатларни GET /v1/works?filter=source:{abi} орқали олинг.

GET/v1/sources

Манбалар рўйхати

Манбаларни саҳифалаб қайтаради. filter, sort ва бошқа list параметрлари қўлланилади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`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`	Чуқур pagination учун 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 endpoint'и йўқ. Ҳужжатларни GET /v1/works?filter=institutions.country_code:{code} каби филтрлар орқали олинг.

GET/v1/institutions

Ташкилотлар рўйхати

Ташкилотларни саҳифалаб қайтаради. filter, sort ва бошқа list параметрлари қўлланилади.

Параметрлар

Ном	Жой	Тур	Тавсиф
`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`	Чуқур pagination учун 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) — барча entity'лар бўйлаб ёки битта entity тури ичида.

GET/v1/autocomplete

Барча entity'лар

Барча entity турлари бўйлаб 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 тури

Битта entity тури ичида autocomplete.

Параметрлар

Ном	Жой	Тур	Тавсиф
`entity`мажбурий	`path`	`string`	Entity тури.`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

Оммавий кўрсаткичлар — аутентификациясиз. Бу endpoint'лар 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"