What is the endpoint for [B069] Translational medicine search?

The [B069] Translational medicine search endpoint is POST https://connect.patsnap.com/synapse/translational/medicine/search.

Where can I find the OpenAPI schema for [B069] Translational medicine search?

The OpenAPI schema is available at /openapi.json#/paths/~1synapse~1translational~1medicine~1search/post. You can also browse the full specification at /openapi.json.

[B069] Translational medicine search

Q: What data can [B069] Translational medicine search return?

[B069] Translational medicine search Obtain translational medicine data through fields such as drug, target, disease, organization, subject, translation stage, journal, conference, etc. See the Response Schema and Success Response Example on this page for the full structure.

post

https://connect.patsnap.com/synapse/translational/medicine/search

Try in Sandbox

Obtain translational medicine data through fields such as drug, target, disease, organization, subject, translation stage, journal, conference, etc.

One or more of these parameters must exist: drug, target, disease, organizations, mechanism, drugType, keywords, subject, translationStage, publicationDate, journal, conference. The keywords parameter supports a maximum of 20 values. The conference value can be obtained from the product, and the conference and year should be separated by a space.

Request Parameters

List of parameters supported by this API endpoint

Name	Type	Example	Description
`conference`	`array`	`[ "WCLC 2025", "AACR 2024", "ADA 2025" ]`	Conference name, ASN 2025 \| ESMO 2025 \| EHA 2025 \| ASCO 2025 \| AACR 2025 \| ESMO_ELCC 2025 \| ASCO_GU 2025 \| ASCO_GI 2025 \| ASH 2024
`disease`	`array`	`[ "f98fd32baa8447119bb87f84093b925c", "74d974da49ba407195b38595a0aff704" ]`	Disease
`drug`	`object`	`Please check the form: DrugFilterAndCondition`	Drug, condition defaults to OR, does not support AND
`condition`	`string`	`OR`	Condition, OR or AND
`value`	`array`	`[ "c7a2671dc0574f19bc42d557eca3906f", "9ae626b75273433f8f4203ee3f7aa181" ]`	Value list
`drug_type`	`array`	`[ "6718bf09d6024f4db4f309a4cc791cf6", "6be383aaee904d2b8321e2d1fdacf8bb" ]`	Drug type
`journal`	`array`	`[ "N Engl J Med", "Nat Med" ]`	Journal name, Nature \| Science \| Cell \| Lancet \| N Engl J Med \| Proc Natl Acad Sci U S A \| Nat Commun \| Nat Genet \| Nat Med \| Sci Transl Med \| J Med Chem
`keywords`	`object`	`Please check the form: KeywordsFilterAndCondition`	Keywords
`condition`	`string`	`OR`	Condition, OR or AND
`value`	`array`	`[ "Sacituzumab govitecan", "Oral" ]`	Value list
`limit`	`integer<int64>`	`10`	Number of returned items, default 10. offset + limit <= 10000, maximum limit setting 100
`mechanism`	`array`	`[ "cf1cf8ea0f9b80ee88876a3324ceac99", "888b99dda6a62ef2551937c34e253e9c" ]`	Mechanism of action
`offset`	`integer<int64>`	-	Offset, default 0
`organizations`	`array`	`[ "5c1eb05d43334b6d6d7973ee3073b7b4", "52aee12631589b24dca3ae62de8a0886" ]`	Organization
`publication_date`	`object`	`Please check the form: PublicationDateFilter`	Publication Date, 1:within 1 week \| 2:within 1 month \| 3:within 1 year \| 4:within 3 years \| 5:Custom
`end_date`	`string`	`2024-12-31`	End time (used when custom)
`start_date`	`string`	`2024-01-01`	Start time (used when custom)
`type`	`integer<int32>`	`4`	Time range type, 1:within 1 week \| 2:within 1 month \| 3:within 1 year \| 4:within 3 years \| 5:Custom
`sort`	`array`	`Please check the form: SortField`	Field sorting, field supports: PUB_DT, order supports desc, asc (default desc)
`field`	`string`	`PUB_DT`	Sort field, supports: PUB_DT
`order`	`string`	`desc`	Sort order, desc or asc, default desc
`subject`	`array`	`[ "3期临床研究" ]`	Subject/Tag, Epidemiology\|Pathogenesis\|Target\|Biomarker\|Structural Biology\|Discovery/Preclinical\|Phase 1 Clinical\|Phase 1/2 Clinical\|Phase 2 Clinical\|Phase 2/3 Clinical\|Phase 3 Clinical\|Post-Marketing Study\|Real-World Research\|New Technology
`target`	`object`	`Please check the form: TargetFilterAndCondition`	Target, condition defaults to OR, supports AND
`condition`	`string`	`OR`	Condition, OR or AND
`value`	`array`	`[ "d8cdb9ce63174077a9ef868b39bf3421", "c385dcba5fea4e97bf02bc256757613a" ]`	Value list
`translation_stage`	`array`	`[ "T2" ]`	Translational Stage, T0 \| T1 \| T2 \| T3

Request Example

Example request body for this API endpoint

JSON

{
  "drug": {
    "value": [
      "c7a2671dc0574f19bc42d557eca3906f",
      "9ae626b75273433f8f4203ee3f7aa181"
    ],
    "condition": "OR"
  },
  "sort": [
    {
      "field": "PUB_DT",
      "order": "desc"
    }
  ],
  "limit": 10,
  "offset": 0,
  "target": {
    "value": [
      "d8cdb9ce63174077a9ef868b39bf3421",
      "c385dcba5fea4e97bf02bc256757613a"
    ],
    "condition": "OR"
  },
  "disease": [
    "f98fd32baa8447119bb87f84093b925c",
    "74d974da49ba407195b38595a0aff704"
  ],
  "journal": [
    "N Engl J Med",
    "Nat Med"
  ],
  "subject": [
    "3期临床研究"
  ],
  "keywords": {
    "value": [
      "Sacituzumab govitecan",
      "Oral"
    ],
    "condition": "OR"
  },
  "drug_type": [
    "6718bf09d6024f4db4f309a4cc791cf6",
    "6be383aaee904d2b8321e2d1fdacf8bb"
  ],
  "mechanism": [
    "cf1cf8ea0f9b80ee88876a3324ceac99",
    "888b99dda6a62ef2551937c34e253e9c"
  ],
  "conference": [
    "WCLC 2025",
    "AACR 2024",
    "ADA 2025"
  ],
  "organizations": [
    "5c1eb05d43334b6d6d7973ee3073b7b4",
    "52aee12631589b24dca3ae62de8a0886"
  ],
  "publication_date": {
    "type": 4,
    "end_date": "2024-12-31",
    "start_date": "2024-01-01"
  },
  "translation_stage": [
    "T2"
  ]
}

Response Schema

Structure of the API response data

Field Name	Type	Example	Description
`data`	`object`	-	response data
`items`	`array`	`Please check the form:TranslationalMedicineSearchDataDetail`	Result Items
`drugs`	`array`	`Please check the form: CommonDrug`	Drugs
`drug_id`	`string`	`e82b83b42eba4e5ea3f26f8e06081a5a`	Drug ID
`display_name`	`array`	`[ { "lang": "EN", "name": "Ranibizumab (Genentech)" }, { "lang": "CN", "name": "雷珠单抗" } ]`	Drug Name, Referencing "CommonName"
`lang`	`string`	`EN`	Language
`name`	`string`	`Ranibizumab (Genentech)`	Drug,Target,Organization,Disease,Country/Location,DICT,Mechanism Action Name
`title`	`string`	`Novel Biomarker Discovery in Cancer Research`	Title
`disease`	`array`	`Please check the form: CommonDisease`	Disease
`disease_id`	`string`	`06a9082fe1ec4c97bea31d888b9cfdce`	Disease ID
`display_name`	`array`	`[ { "lang": "EN", "name": "Uveitic Macular Edema" }, { "lang": "CN", "name": "葡萄膜炎黄斑水肿" } ]`	Disease Name, Referencing "CommonName"
`journal`	`object`	`Please check the form: CommonNorIdName`	Journal
`name`	`string`	`Acute Kidney Injury`	name
`normalized_id`	`string`	`87bfaf037f8e60c9e25595cd98bb27e4`	Normalized ID
`subject`	`array`	`Please check the form: CommonNorIdName`	Subject
`targets`	`array`	`Please check the form: CommonTarget`	Targets
`target_id`	`string`	`1c2067e5ab054a8995f73efcfcf56207`	Target ID
`short_name`	`array`	`[ { "lang": "EN", "name": "VEGF" } ]`	Target Short Name, Referencing "CommonName"
`display_name`	`array`	`[ { "lang": "EN", "name": "Vascular endothelial growth factor" }, { "lang": "CN", "name": "血管内皮生长因子" } ]`	Target Full Name, Referencing "CommonName"
`drug_type`	`array`	`Please check the form: CommonDictionary`	Drug Type
`display_name`	`array`	`[ { "lang": "EN", "name": "Autologous CAR-T" }, { "lang": "CN", "name": "自体CAR-T" } ]`	Dict Name
`normalized_id`	`string`	`2fbfdb3e92d942c48cbb0adb79f23526`	Dict ID
`technology`	`array`	`Please check the form: CommonNorIdName`	Technology
`source_info`	`array`	`Please check the form: TranslationalMedicineSourceInfo`	Source Info
`code`	`string`	`NATURE-2024-001`	Code
`source`	`string`	`Nature`	Source
`patsnap_id`	`string`	`patsnap_1234567890`	PatSnap ID
`source_url`	`string`	`https://www.nature.com/articles/s41586-024-01234-5`	Source URL
`normalized_source_id`	`string`	`368cf867-f484-430e-9530-44f5cccdd973`	Normalized Source ID
`normalized_source_category`	`string`	`Journal`	Normalized Source Category
`organization`	`array`	`Please check the form: CommonOrganization`	Organization
`display_name`	`array`	`[ { "lang": "EN", "name": "Roche Holding AG" }, { "lang": "CN", "name": "罗氏" } ]`	Organization Name, Referencing "CommonName"
`organization_id`	`string`	`87bfaf037f8e60c9e25595cd98bb27e4`	Organization ID
`mechanism_action`	`array`	`Please check the form: CommonMechanismAction`	Mechanism Action
`short_name`	`array`	`[ { "lang": "EN", "name": "KRAS G12C inhibitors" }, { "lang": "CN", "name": "KRAS G12C抑制剂" } ]`	Mechanism Action Short Name
`display_name`	`array`	`[ { "lang": "EN", "name": "GTPase KRas G12C inhibitors" }, { "lang": "CN", "name": "KRAS G12C突变抑制剂" } ]`	Mechanism Action Name
`mechanism_id`	`string`	`27c0848a265e4332836e10d0e8202b4c`	Mechanism Action ID
`publication_date`	`string`	`2024-01-15`	Publication Date
`translation_stage`	`array`	`Please check the form: CommonNorIdName`	Translation Stage
`translational_medicine_id`	`string`	`tm_1234567890abcdef`	Translational Medicine ID
`limit`	`integer<int64>`	`10`	limit
`total`	`integer<int64>`	`10`	total
`offset`	`integer<int64>`	-	offset
`status` Required	`boolean`	`false`	Status
`error_msg`	`string`	`The request parameter format is incorrect！`	Error Message
`error_code` Required	`integer`	`0`	Error Code

Success Response Example

Example of a successful API response

JSON

{
  "data": {
    "items": [
      {
        "drugs": [
          {
            "drug_id": "e82b83b42eba4e5ea3f26f8e06081a5a",
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "title": "Novel Biomarker Discovery in Cancer Research",
        "disease": [
          {
            "disease_id": "06a9082fe1ec4c97bea31d888b9cfdce",
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "journal": {
          "name": "Acute Kidney Injury",
          "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
        },
        "subject": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "targets": [
          {
            "target_id": "1c2067e5ab054a8995f73efcfcf56207",
            "short_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ]
          }
        ],
        "drug_type": [
          {
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "normalized_id": "2fbfdb3e92d942c48cbb0adb79f23526"
          }
        ],
        "technology": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "source_info": [
          {
            "code": "NATURE-2024-001",
            "source": "Nature",
            "patsnap_id": "patsnap_1234567890",
            "source_url": "https://www.nature.com/articles/s41586-024-01234-5",
            "normalized_source_id": "368cf867-f484-430e-9530-44f5cccdd973",
            "normalized_source_category": "Journal"
          }
        ],
        "organization": [
          {
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "organization_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "mechanism_action": [
          {
            "short_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "display_name": [
              {
                "lang": "EN",
                "name": "Ranibizumab (Genentech)"
              }
            ],
            "mechanism_id": "27c0848a265e4332836e10d0e8202b4c"
          }
        ],
        "publication_date": "2024-01-15",
        "translation_stage": [
          {
            "name": "Acute Kidney Injury",
            "normalized_id": "87bfaf037f8e60c9e25595cd98bb27e4"
          }
        ],
        "translational_medicine_id": "tm_1234567890abcdef"
      }
    ],
    "limit": 10,
    "total": 10,
    "offset": 0
  },
  "status": true,
  "error_code": 0
}

Error Codes

List of possible error codes returned by this endpoint

Business Errors

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

Platform Errors

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

HTTP Status Codes

Status Code	Description
`0`	Success
`201`	Created
`401`	Unauthorized
`403`	Forbidden
`404`	Not Found

Performance Metrics

Expected performance characteristics for this endpoint

Normal Response Time

5000 ms

Max Response Time

10000 ms