---
title: "Search scholarly result"
method: POST
path: "/scholarly/search"
tags: ["scholarly"]
---

# Search scholarly result

`POST /scholarly/search`

## Request body

- ScholarlySearchRequest
  - `query` object — Json query object
  - `size` integer — Number of items per page
  - `from` integer — Offset from the first result
  - `include` string[] — Fields to be included in result
  - `sort` object[] — Array of object mappings to specify field sorting
  - `exclude` string[] — Fields to be excluded from result
  - `scroll` string — Scroll context time in minute (e.g. 1m)
  - `scroll_id` string — For scroll based pagination, provide scroll_id from previous response body.

## Response `200`

Valid response from the server

- ScholarApiResponse
  - `total` integer — Total number of search results exists.
  - `results` integer — Number of results in this response.
  - `data` object[] — List of scholarly records
    - `patent_citations` object[]
      - `lens_id` string
    - `patent_citations_count` integer
    - `lens_id` string
    - `alias_lens_ids` string[]
    - `created` string
    - `open_access` object
      - `license` string
      - `colour` string
    - `publication_type` string
    - `publication_supplementary_type` string[]
    - `authors` object[]
      - `first_name` string
      - `last_name` string
      - `initials` string
      - `affiliations` object[]
        - `name` string
        - `grid_id` string
        - `country_code` string
      - `ids` object[]
        - `type` string
        - `value` string
    - `title` string
    - `volume` string
    - `issue` string
    - `languages` string[]
    - `references` object[]
      - `lens_id` string
    - `keywords` string[]
    - `mesh_terms` object[]
      - `mesh_heading` string
      - `qualifier_name` string
      - `mesh_id` string
      - `qualifier_id` string
    - `chemicals` object[]
      - `substance_name` string
      - `registry_number` string
      - `mesh_id` string
    - `clinical_trials` object[]
      - `id` string
      - `registry` string
    - `fields_of_study` string[]
    - `funding` object[]
      - `org` string
      - `funding_id` string
      - `country` string
    - `source_urls` object[]
      - `type` string
      - `url` string
    - `abstract` string
    - `year_published` integer
    - `references_count` integer
    - `scholarly_citations_count` integer
    - `external_ids` object[]
      - `type` string
      - `value` string
    - `start_page` string
    - `end_page` string
    - `source` object
      - `title` string
      - `type` string
      - `publisher` string
      - `issn` object[]
        - `type` string
        - `value` string
      - `country` string
      - `asjc_codes` string[]
      - `asjc_subjects` string[]
    - `scholarly_citations` string[]
    - `author_count` integer
    - `date_published` string

## Other responses

- `204` — No Content
- `400` — Malformed request or incorrect fields/values provided
- `401` — Authentication credentials might be incorrect or missing
- `404` — Incorrect Resource URL / Empty Result for supplied queries / Expired scroll_id
- `415` — Request body is not json or Content Type is not application/json
- `429` — You have exceeded the number of allowed calls

---

[API](https://skmtc.net/lens/apis/lens-api.md) · [All operations](https://skmtc.net/lens/apis/lens-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lens/lens-api/revisions/4212453c4c6a/schema)