API / Docs

AkademBase API

REST, JSON, and API-key authentication via a header. Below: endpoint groups, authentication and usage rules.

Getting Started

The AkademBase API is REST-based, returns JSON and authenticates with a Bearer key. Below: the base URL, authentication, pagination, errors and the endpoint reference.

All requests accept and return JSON. For POST requests, send Content-Type: application/json.

Base URLhttps://api.akadembase.org

This interactive reference is generated from the live OpenAPI specification covering the 19 public read endpoints. For the conceptual guide — authentication, pagination, errors and rate limits — see the API docs.

OpenAPI Reference Download OpenAPI spec (JSON)

Technical content: Endpoint names, parameter names, JSON fields and ABI strings stay English in every locale.

Authentication

Every /v1/* request requires a Bearer key in the Authorization header. The key is gated — request one via the Access page.

bash

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

Keep the key server-side and route requests through your own server-side proxy — the key must never reach the browser (client).

Pagination

There are two pagination models, depending on the endpoint.

List endpoints: Paged with page and per_page (default 25, max 200). meta.count is the total; for deep pagination pass meta.next_cursor as cursor on the next request.
Search: POST /v1/search differs — it uses offset and limit, and returns total in the response.

Errors

Errors return standard HTTP status codes. There are two JSON shapes: RFC 7807 (problem+json) and a detailed shape for parameter validation.

`400`	`Bad Request`	Malformed ABI or unknown filter field.
`401`	`Unauthorized`	Missing or invalid key.
`404`	`Not Found`	Well-formed but nonexistent ABI.
`422`	`Validation Error`	Invalid parameter value (e.g. per_page > 200).
`429`	`Too Many Requests`	Rate limit exceeded — 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'}]"
}

Some 400 responses are helpful — e.g. an unknown filter field returns the list of allowed fields.

Rate limits

For stable use of the API, follow three simple rules:

Cache: Cache responses — don't re-send the same request.
Identify yourself: Send a clear User-Agent and contact detail.
Back off: On a 429 (Too Many Requests), back off and retry later.

Limits are tier-based: Academic (free) and Partner (paid). Vector / semantic calls are metered under a separate quota. Exact numbers will be published later.

Endpoints

Search

Keyword, semantic and hybrid search — the flagship endpoint. Results come with facets over the filtered set.

POST/v1/search

Search

Searches across documents and returns results with facets. Filters are single-valued: each filter field takes one value. The facets object is computed per dimension over the filtered set.

Parameters

Name	In	Type	Description
`query`required	`body`	`string`	Search query.
`limit`optional	`body`	`integer`default: `10`	Number of results to return.
`offset`optional	`body`	`integer`default: `0`	Offset for pagination.
`year`optional	`body`	`integer`	Filter by publication year.
`type`optional	`body`	`string`	Document type (e.g. article, chapter).
`source`optional	`body`	`string`	Filter by source ABI.
`topic`optional	`body`	`string`	Filter by topic ABI.
`language`optional	`body`	`string`	Filter by document language (matches the facet).
`lang`optional	`body`	`string`	Optional language preference; unlike language, it does not filter which documents match.
`country`optional	`body`	`string`	Filter by country code.

Request body

JSON

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

Response example

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 are returned over the year, type, source, topic, language and country dimensions. Each bucket has key, key_display_name, count.

Works

Documents (works) — full metadata, authors, source, topics and citation links.

GET/v1/works/{abi}

A single work

The full record of one work (DocumentRead): authors, source, topics, external IDs, cited_by_count and reference_count.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The work's ABI.

Response example

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"

An ABI contains : and / characters, so URL-encode it in the path (: → %3A, / → %2F).

GET/v1/works

List works

Returns works paged (WorksListResponse). filter and sort allow powerful queries.

Parameters

Name	In	Type	Description
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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 fields: cited_by, cites, year, type, source, topic, language, authorships.author, institutions.country_code, doi, record_origin. sort supports cited_by_count:desc. Note: cited_by_count is sortable but not filterable.

GET/v1/works/{abi}/citations

Citations (incoming)

Works that cite this work — incoming citations. meta.count = cited_by_count.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The work's ABI.
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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"

Mind the direction: /citations is WHO cites this work (incoming); /references is WHAT this work cites (outgoing).

GET/v1/works/{abi}/references

References (outgoing)

Works this work references — outgoing references. meta.count = reference_count.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The work's ABI.
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

Authors — profile metadata and their works.

GET/v1/authors/{abi}

A single author

Author profile: display_name, name_variants, orcid, last_known_institution, works_count, cited_by_count, h_index, i10_index.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The author's ABI.

Response example

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"

An ABI contains : and / characters, so URL-encode it in the path (: → %3A, / → %2F).

GET/v1/authors/{abi}/works

Author's works

Works authored by this author (WorksListResponse). All list parameters apply.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The author's ABI.
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

List authors

Returns authors paged. filter, sort and the other list parameters apply.

Parameters

Name	In	Type	Description
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

Topics — hierarchical classification (level, parent) and works by topic.

GET/v1/topics/{abi}

A single topic

Topic profile: display_name, level, parent, works_count, cited_by_count.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The topic's ABI.

Response example

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"

An ABI contains : and / characters, so URL-encode it in the path (: → %3A, / → %2F).

GET/v1/topics/{abi}/works

Works by topic

Works classified under this topic (WorksListResponse).

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The topic's ABI.
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

List topics

Returns topics paged. filter, sort and the other list parameters apply.

Parameters

Name	In	Type	Description
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

Sources — metadata for journals, repositories and publishers.

GET/v1/sources/{abi}

A single source

Source profile: display_name, type, issn_l, publisher, country_code, works_count, cited_by_count, h_index.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The source's ABI.

Response example

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"

There is no separate /works for a source. Get a source's works via GET /v1/works?filter=source:{abi}.

GET/v1/sources

List sources

Returns sources paged. filter, sort and the other list parameters apply.

Parameters

Name	In	Type	Description
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

Institutions — metadata for universities and research organizations.

GET/v1/institutions/{abi}

A single institution

Institution profile: display_name, aliases, ror, country_code, status, works_count, author_count, cited_by_count, h_index.

Parameters

Name	In	Type	Description
`abi`required	`path`	`string`	The institution's ABI.

Response example

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"

There is no separate /works for an institution. Get works via filters such as GET /v1/works?filter=institutions.country_code:{code}.

GET/v1/institutions

List institutions

Returns institutions paged. filter, sort and the other list parameters apply.

Parameters

Name	In	Type	Description
`search`optional	`query`	`string`	Full-text search within the collection.
`filter`optional	`query`	`string`	Filter expression as field:value; combine conditions with a comma (AND).
`sort`optional	`query`	`string`	Sort as field:desc or field:asc.
`select`optional	`query`	`string`	Comma-separated list of fields to trim the response.
`group_by`optional	`query`	`string`	Group results by a field (aggregation).
`page`optional	`query`	`integer`default: `1`	1-based page number.
`per_page`optional	`query`	`integer`default: `25`	Items per page (max 200).
`cursor`optional	`query`	`string`	Cursor from meta.next_cursor for deep pagination.

Response example

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

Fast prefix search (typeahead) — across all entities or within one entity type.

GET/v1/autocomplete

All entities

Autocomplete across all entity types. It is cross-script — both Cyrillic and Latin queries match.

Parameters

Name	In	Type	Description
`q`required	`query`	`string`	Query prefix.
`limit`optional	`query`	`integer`default: `10`	Number of results.

Response example

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}

A single entity type

Autocomplete within a single entity type.

Parameters

Name	In	Type	Description
`entity`required	`path`	`string`	Entity type.`authorsinstitutionssourcestopicsworks`
`q`required	`query`	`string`	Query prefix.
`limit`optional	`query`	`integer`default: `10`	Number of results.

Response example

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

Public metrics — no authentication. These endpoints do not require a Bearer key.

GET/public/statsNo authentication required

Corpus stats

Corpus size: document and citation counts. No authentication required.

Parameters

No parameters.

Response example

JSON

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

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

GET/public/activityNo authentication required

Usage activity

Usage metrics: searches, works viewed, cross-lingual searches (total and 30-day). No authentication required.

Parameters

No parameters.

Response example

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"