---
title: "L001 Literature Search"
method: POST
path: "/search/literature/query-search"
tags: ["Literature Data"]
---

# L001 Literature Search

`POST /search/literature/query-search`

## Request

- Base URL: `https://connect.patsnap.com`
- URL: `https://connect.patsnap.com/search/literature/query-search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/docs/search/literature/query-search/post.ts> (a function with typed inputs; its response is checked against the schema)

Search and query our global literature database by entering the title, abstract, author, and other details of the literature.

## Request body

- L001LiteratureQuerySearchRequest
  - `date_time` string: Publication timestamp range
  - `limit` integer: limit of returned response; must be <= 1,00
  - `offset` integer: offset value; limit + offset <= 10000
  - `query_text` string: You can search and query our global literature repository by entering document titles, abstracts, authors, and other metadata. Maximum Search Text Length: 800 characters. Support logic connector AND/OR Supported Search Fields: title: Document title abstract: Document abstract author: Author name date_time: Publication timestamp range publication: Journal name author Parameters need to be enclosed in double quotation marks
  - `text` string: The text input for literature search.
  - `type` string: Supported text types for literature include： title: (literature title) abstract：(literature abstract) author：(literature author) publication：(literature publication) title/abstract：(literature title or abstract) all：(the above fields)

## Response `200`

Successful l001 literature search response.

- L001LiteratureQuerySearchResponse
  - `data` L001LiteratureQuerySearchSearchLiteratureResponse
    - `results` L001LiteratureQuerySearchLiteratureSearch[]: result
      - `doi` string: DOI
      - `title` unknown[]: Title
        - unknown
      - `author` unknown[]: Author
        - unknown
      - `paper_id` string: Paper ID
    - `result_count` integer: Received result count
    - `total_search_result_count` integer: Total search result count
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `201`: Created.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found.

---

[API](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api.md) - [All operations](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/revisions/c2264a0de595?raw)