[B042] Single Chemical Structure Literature Search

post
https://connect.patsnap.com/synapse/chemical/paper/search
Try in Sandbox

Search related papers through InChI Key ID, including title, abstract, author, institution, publication, publication date, etc.

inchi_key_id is required, supports sorting by publication date

Request Parameters

List of parameters supported by this API endpoint

NameTypeExampleDescription
inchi_key_id
Required
string126213117
InChI Key ID
lang
stringCN
Language, support: CN, EN
page
integer<int32>1
Page number, starting from 1, default 1
rows
integer<int32>100
Rows per page, default 10, maximum 100
sort_order
stringdesc
Sort by published time, sort order, support:desc,asc

Response Schema

Structure of the API response data

Field NameTypeExampleDescription
data
object-
response data
page
integer<int32>1
Current page number
rows
integer<int32>10
Rows per page
items
arrayPlease check the form:ChemicalPaperDetail
Result items
doi
string10.1007/s00262-011-1007-5
DOI
title
stringEnhanced programmed death 1 (PD-1) and PD-1 ligand (PD-L1) expression in patients with actinic cheilitis and oral squamous cell carcinoma
Title
author
array[ "John Smith", "Jane Doe" ]
Author
pubmed
array[ "https://pubmed.ncbi.nlm.nih.gov/39912419" ]
PubMed
source
stringhttps://www.tandfonline.com/doi/pdf/10.1080/14756366.2025.2460053
Source
doc_type
stringJournal
Document Type
paper_id
string74e6849a-a4a1-3d18-badc-472c56ba7ae5
id
epub_date
string20110327
Epub Date
institution
array[ "University of California", "Harvard Medical School" ]
Institution
publication
stringCancer Immunology, Immunotherapy
Publication
abstract_text
stringProgrammed death 1 (PD-1) and its ligand PD-L1 are key immune checkpoint molecules...
Abstract
published_date
string20110701
Published Date
structure_count
integer<int32>5
Structure Count
total
integer<int64>100
Total
status
Required
booleanfalse
Status
error_msg
stringThe request parameter format is incorrect!
Error Message
error_code
Required
integer0
Error Code

Success Response Example

Example of a successful API response

JSON
{
  "data": {
    "page": 1,
    "rows": 10,
    "items": [
      {
        "doi": "10.1007/s00262-011-1007-5",
        "title": "Enhanced programmed death 1 (PD-1) and PD-1 ligand (PD-L1) expression in patients with actinic cheilitis and oral squamous cell carcinoma",
        "author": [
          "John Smith",
          "Jane Doe"
        ],
        "pubmed": [
          "https://pubmed.ncbi.nlm.nih.gov/39912419"
        ],
        "source": "https://www.tandfonline.com/doi/pdf/10.1080/14756366.2025.2460053",
        "doc_type": "Journal",
        "paper_id": "74e6849a-a4a1-3d18-badc-472c56ba7ae5",
        "epub_date": 20110327,
        "institution": [
          "University of California",
          "Harvard Medical School"
        ],
        "publication": "Cancer Immunology, Immunotherapy",
        "abstract_text": "Programmed death 1 (PD-1) and its ligand PD-L1 are key immune checkpoint molecules...",
        "published_date": 20110701,
        "structure_count": 5
      }
    ],
    "total": 100
  },
  "status": true,
  "error_code": 0
}

Error Codes

List of possible error codes returned by this endpoint

Business Errors

Error CodeDescription
68300004Invalid parameter!
68300005Search api failure!
68300006Analytic basic access error!
68300007Bad request!
68300008Service error, please try again later!
68300010The file does not comply with upload specifications!

Platform Errors

Error CodeDescription
67200000API call exceeds the total limit set by the platform!
67200001API call exceeds the total limit set by the platform!
67200002The current call rate is too fast, exceeding the current configuration limit QPS!
67200003The key and secret parameters for applying for the token are incorrect or the client has been disabled!
67200004The requested api does not have permission. Please contact our support personnel!
67200005Insufficient account balance/number of calls!
67200006The client has exceeded the activation validity period!
67200007The current call exceeds the configured usage limit of the day!
67200008Please check if the required apikey in the query parameter has been transmitted!
67200009The apikey does not match the passed bearerToken. Please check if a valid token is being used!
67200012The request is illegal!
67200100The current server status is busy, request response timeout!
67200101The API requested currently does not exist. Please check the request path!

HTTP Status Codes

Status CodeDescription
0Success
201Created
401Unauthorized
403Forbidden
404Not Found

Performance Metrics

Expected performance characteristics for this endpoint

Normal Response Time

5000 ms

Max Response Time

10000 ms