API / Hujjatlar

AkademBase API

REST, JSON va header orqali API-key autentifikatsiya. Quyida endpoint guruhlari, autentifikatsiya va foydalanish qoidalari.

Boshlash

AkademBase API — REST asosida, JSON qaytaradi va Bearer kalit bilan autentifikatsiya qilinadi. Quyida bazaviy URL, autentifikatsiya, pagination, xatolar va endpoint reference.

Barcha so'rovlar JSON qabul qiladi va qaytaradi. POST so'rovlar uchun Content-Type: application/json yuboring.

Bazaviy URLhttps://api.akadembase.org

Ushbu interaktiv ma'lumotnoma 19 ta ochiq o'qish endpoint'ini qamrab oluvchi jonli OpenAPI spetsifikatsiyasidan generatsiya qilinadi. Konseptual qo'llanma — autentifikatsiya, pagination, xatolar va rate limitlar — uchun API hujjatlariga qarang.

OpenAPI ma'lumotnoma OpenAPI spetsifikatsiyasini yuklab olish (JSON)

Texnik kontent: Endpoint nomlari, parametr nomlari, JSON maydonlari va ABI satrlari barcha tillarda inglizcha bo'lib qoladi.

Autentifikatsiya

Har bir /v1/* so'rovi Authorization sarlavhasida Bearer kalitni talab qiladi. Kalit gated — uni olish uchun Access sahifasiga murojaat qiling.

bash

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

Kalitni server tomonda saqlang va so'rovlarni o'zingizning server-side proxy'ingiz orqali yuboring — kalit hech qachon brauzerga (klientga) tushmasligi kerak.

Pagination

Ikki xil pagination modeli bor — qaysi endpoint'ga qarab.

Ro'yxat (list) endpoint'lar: page va per_page (default 25, maksimum 200) bilan sahifalanadi. meta.count — umumiy soni; chuqur pagination uchun meta.next_cursor qiymatini keyingi so'rovda cursor sifatida yuboring.
Qidiruv (search): POST /v1/search boshqacha — offset va limit bilan ishlaydi, javobda total qaytadi.

Xatolar

Xatolar standart HTTP status kodlari bilan qaytadi. Ikki xil JSON shakli bor: RFC 7807 (problem+json) va parametr validatsiyasi uchun batafsil shakl.

`400`	`Bad Request`	Noto'g'ri ABI yoki noma'lum filter maydoni.
`401`	`Unauthorized`	Kalit yo'q yoki yaroqsiz.
`404`	`Not Found`	To'g'ri shakldagi, lekin mavjud bo'lmagan ABI.
`422`	`Validation Error`	Parametr qiymati yaroqsiz (masalan, per_page > 200).
`429`	`Too Many Requests`	Rate limit oshib ketdi — back off qiling.

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'}]"
}

Ba'zi 400 javoblari foydali maslahat beradi — masalan noma'lum filter maydonida ruxsat etilgan maydonlar ro'yxati qaytadi.

Rate limits

API'dan barqaror foydalanish uchun uchta oddiy qoidaga amal qiling:

Cache: Javoblarni keshlang — bir xil so'rovni qayta yubormang.
Identify yourself: Aniq User-Agent va aloqa ma'lumotini yuboring.
Back off: 429 (Too Many Requests) kelganda kuting va keyin qayta urinib ko'ring.

Limitlar tier asosida: Akademik (bepul) va Partner (pulli). Vektor / semantik chaqiruvlar alohida kvota ostida hisoblanadi. Aniq raqamlar keyinroq e'lon qilinadi.

Endpoint'lar

Search

Keyword, semantik va gibrid qidiruv — flagman endpoint. Natijalar bilan birga filtrlangan to'plam ustidagi facet'lar qaytadi.

POST/v1/search

Qidiruv

Hujjatlar bo'ylab qidiradi va facet'lar bilan natija qaytaradi. Filtrlar bitta qiymatli (single-valued): har bir filtr maydoni bitta qiymat oladi. facets obyekti har bir o'lcham (dimension) bo'yicha filtrlangan to'plam ustida hisoblanadi.

Parametrlar

Nom	Joy	Tur	Tavsif
`query`majburiy	`body`	`string`	Qidiruv matni.
`limit`ixtiyoriy	`body`	`integer`default: `10`	Qaytariladigan natijalar soni.
`offset`ixtiyoriy	`body`	`integer`default: `0`	Pagination uchun siljish.
`year`ixtiyoriy	`body`	`integer`	Nashr yili bo'yicha filtr.
`type`ixtiyoriy	`body`	`string`	Hujjat turi (masalan article, chapter).
`source`ixtiyoriy	`body`	`string`	Manba ABI bo'yicha filtr.
`topic`ixtiyoriy	`body`	`string`	Mavzu ABI bo'yicha filtr.
`language`ixtiyoriy	`body`	`string`	Hujjat tili bo'yicha filtr (facet bilan mos keladi).
`lang`ixtiyoriy	`body`	`string`	Ixtiyoriy til afzalligi; language'dan farqli o'laroq, qaysi hujjatlar mos kelishini filtrlamaydi.
`country`ixtiyoriy	`body`	`string`	Mamlakat kodi bo'yicha filtr.

So'rov tanasi (request body)

JSON

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

Javob namunasi

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 o'lchamlari bo'yicha qaytadi. Har bir bucket: key, key_display_name, count.

Works

Hujjatlar (works) — to'liq metama'lumot, mualliflar, manba, mavzular va iqtibos aloqalari.

GET/v1/works/{abi}

Bitta hujjat

Bitta hujjatning to'liq yozuvi (DocumentRead): mualliflar, manba, mavzular, tashqi ID'lar, cited_by_count va reference_count.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Hujjatning ABI'si.

Javob namunasi

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 satri : va / belgilarini o'z ichiga oladi, shuning uchun uni path'da URL-encode qiling (: → %3A, / → %2F).

GET/v1/works

Hujjatlar ro'yxati

Hujjatlarni sahifalab qaytaradi (WorksListResponse). filter va sort bilan kuchli so'rovlar tuzish mumkin.

Parametrlar

Nom	Joy	Tur	Tavsif
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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 maydonlari: cited_by, cites, year, type, source, topic, language, authorships.author, institutions.country_code, doi, record_origin. sort cited_by_count:desc'ni qo'llaydi. Eslatma: cited_by_count saralanadi, lekin filterlanmaydi.

GET/v1/works/{abi}/citations

Iqtiboslar (kiruvchi)

Ushbu hujjatga iqtibos keltirgan hujjatlar — kiruvchi iqtiboslar. meta.count = cited_by_count.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Hujjatning ABI'si.
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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"

Yo'nalishga e'tibor bering: /citations — bu hujjatni KIM iqtibos qilgani (kiruvchi); /references — bu hujjat KIMGA murojaat qilgani (chiquvchi).

GET/v1/works/{abi}/references

Murojaatlar (chiquvchi)

Ushbu hujjat murojaat qilgan hujjatlar — chiquvchi havolalar. meta.count = reference_count.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Hujjatning ABI'si.
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Mualliflar — profil metama'lumoti va ularning hujjatlari.

GET/v1/authors/{abi}

Bitta muallif

Muallif profili: display_name, name_variants, orcid, last_known_institution, works_count, cited_by_count, h_index, i10_index.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Muallifning ABI'si.

Javob namunasi

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 satri : va / belgilarini o'z ichiga oladi, shuning uchun uni path'da URL-encode qiling (: → %3A, / → %2F).

GET/v1/authors/{abi}/works

Muallifning hujjatlari

Muallif chiqargan hujjatlar (WorksListResponse). Barcha list parametrlari qo'llaniladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Muallifning ABI'si.
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Mualliflar ro'yxati

Mualliflarni sahifalab qaytaradi. filter, sort va boshqa list parametrlari qo'llaniladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Mavzular — ierarxik tasnif (level, parent) va mavzu bo'yicha hujjatlar.

GET/v1/topics/{abi}

Bitta mavzu

Mavzu profili: display_name, level, parent, works_count, cited_by_count.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Mavzuning ABI'si.

Javob namunasi

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 satri : va / belgilarini o'z ichiga oladi, shuning uchun uni path'da URL-encode qiling (: → %3A, / → %2F).

GET/v1/topics/{abi}/works

Mavzu bo'yicha hujjatlar

Ushbu mavzuga tegishli hujjatlar (WorksListResponse).

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Mavzuning ABI'si.
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Mavzular ro'yxati

Mavzularni sahifalab qaytaradi. filter, sort va boshqa list parametrlari qo'llaniladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Manbalar — jurnallar, repozitoriylar va nashriyotlar metama'lumoti.

GET/v1/sources/{abi}

Bitta manba

Manba profili: display_name, type, issn_l, publisher, country_code, works_count, cited_by_count, h_index.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Manbaning ABI'si.

Javob namunasi

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"

Manba uchun alohida /works endpoint'i yo'q. Bir manbadagi hujjatlarni GET /v1/works?filter=source:{abi} orqali oling.

GET/v1/sources

Manbalar ro'yxati

Manbalarni sahifalab qaytaradi. filter, sort va boshqa list parametrlari qo'llaniladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Tashkilotlar — universitetlar va ilmiy muassasalar metama'lumoti.

GET/v1/institutions/{abi}

Bitta tashkilot

Tashkilot profili: display_name, aliases, ror, country_code, status, works_count, author_count, cited_by_count, h_index.

Parametrlar

Nom	Joy	Tur	Tavsif
`abi`majburiy	`path`	`string`	Tashkilotning ABI'si.

Javob namunasi

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"

Tashkilot uchun alohida /works endpoint'i yo'q. Hujjatlarni GET /v1/works?filter=institutions.country_code:{code} kabi filtrlar orqali oling.

GET/v1/institutions

Tashkilotlar ro'yxati

Tashkilotlarni sahifalab qaytaradi. filter, sort va boshqa list parametrlari qo'llaniladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`search`ixtiyoriy	`query`	`string`	Ushbu to'plam ichida matnli qidiruv.
`filter`ixtiyoriy	`query`	`string`	field:value ko'rinishidagi filtr; bir nechta shartni vergul bilan (AND) birlashtiring.
`sort`ixtiyoriy	`query`	`string`	field:desc yoki field:asc ko'rinishida saralash.
`select`ixtiyoriy	`query`	`string`	Vergul bilan ajratilgan maydonlar ro'yxati — javobni qisqartirish uchun.
`group_by`ixtiyoriy	`query`	`string`	Natijalarni maydon bo'yicha guruhlash (agregatsiya).
`page`ixtiyoriy	`query`	`integer`default: `1`	1-dan boshlanuvchi sahifa raqami.
`per_page`ixtiyoriy	`query`	`integer`default: `25`	Sahifadagi yozuvlar soni (maksimum 200).
`cursor`ixtiyoriy	`query`	`string`	Chuqur pagination uchun meta.next_cursor'dan olingan kursor.

Javob namunasi

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

Tez prefiks-qidiruv (typeahead) — barcha entity'lar bo'ylab yoki bitta entity turi ichida.

GET/v1/autocomplete

Barcha entity'lar

Barcha entity turlari bo'ylab autocomplete. Cross-script ishlaydi — kirill va lotin so'rovlari ham mos keladi.

Parametrlar

Nom	Joy	Tur	Tavsif
`q`majburiy	`query`	`string`	Qidiruv prefiksi.
`limit`ixtiyoriy	`query`	`integer`default: `10`	Natijalar soni.

Javob namunasi

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}

Bitta entity turi

Bitta entity turi ichida autocomplete.

Parametrlar

Nom	Joy	Tur	Tavsif
`entity`majburiy	`path`	`string`	Entity turi.`authorsinstitutionssourcestopicsworks`
`q`majburiy	`query`	`string`	Qidiruv prefiksi.
`limit`ixtiyoriy	`query`	`integer`default: `10`	Natijalar soni.

Javob namunasi

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

Ommaviy ko'rsatkichlar — autentifikatsiyasiz. Bu endpoint'lar Bearer kalit talab qilmaydi.

GET/public/statsAutentifikatsiya talab qilinmaydi

Korpus statistikasi

Korpus hajmi: hujjatlar va iqtiboslar soni. Autentifikatsiya talab qilinmaydi.

Parametrlar

Parametrlar yo'q.

Javob namunasi

JSON

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

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

GET/public/activityAutentifikatsiya talab qilinmaydi

Foydalanish faolligi

Foydalanish ko'rsatkichlari: qidiruvlar, ko'rilgan hujjatlar, cross-lingual qidiruvlar (umumiy va 30 kunlik). Autentifikatsiya talab qilinmaydi.

Parametrlar

Parametrlar yo'q.

Javob namunasi

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"