openapi: 3.1.0
info:
title: KEGG REST conv link API
description: 'The Kyoto Encyclopedia of Genes and Genomes (KEGG) REST API provides programmatic access to KEGG databases covering biological pathways, metabolic networks, molecular interactions, drug targets, disease associations, chemical compounds, genomic sequences, and functional orthologs across thousands of organisms. The API exposes seven core operations — info, list, find, get, conv, link, and ddi — enabling identifier conversion, cross-database linking, keyword and structure searches, and full entry retrieval in text, KGML, and JSON formats. Academic use is free; commercial use requires a license from Pathway Solutions. Rate limit is 3 requests per second per client.
'
version: 1.0.0
contact:
name: KEGG Support
url: https://www.kegg.jp/kegg/feedback.html
termsOfService: https://www.kegg.jp/kegg/legal.html
license:
name: Academic Use Only
url: https://www.kegg.jp/kegg/legal.html
servers:
- url: https://rest.kegg.jp
description: KEGG REST API server
tags:
- name: link
description: Find related entries using database cross-references
paths:
/link/{target_db}/{source_db}:
get:
operationId: linkDatabases
summary: Find cross-references between databases
description: 'Find related entries between two KEGG databases using cross-references. Returns tab-delimited text listing relationships between entries in the source and target databases.
'
tags:
- link
parameters:
- name: target_db
in: path
required: true
description: 'Target KEGG database. Supported: pathway, brite, module, ko, genes, genome, compound, glycan, reaction, rclass, enzyme, disease, drug, dgroup, network, variant, and organism codes.
'
schema:
type: string
example: pathway
- name: source_db
in: path
required: true
description: 'Source KEGG database or organism code.
'
schema:
type: string
example: hsa
responses:
'200':
description: Tab-delimited cross-reference relationships
content:
text/plain:
schema:
type: string
example: "hsa:10458\tpath:hsa04010\nhsa:10458\tpath:hsa04012\n"
'400':
description: Bad request
'404':
description: Not found
/link/{target_db}/{dbentries}:
get:
operationId: linkEntries
summary: Find cross-references for specific entries
description: 'Find related entries in a target KEGG database for specific source entries. Returns tab-delimited cross-reference relationships. Up to 10 entries per request. RDF output formats (turtle, n-triple) are also supported via the option parameter.
'
tags:
- link
parameters:
- name: target_db
in: path
required: true
description: Target KEGG database
schema:
type: string
- name: dbentries
in: path
required: true
description: 'One or more source entry identifiers separated by plus signs. Maximum 10 entries per request.
'
schema:
type: string
example: cpd:C00031+cpd:C00033
responses:
'200':
description: Tab-delimited cross-reference relationships
content:
text/plain:
schema:
type: string
'400':
description: Bad request
'404':
description: Not found
externalDocs:
description: KEGG API Documentation
url: https://www.kegg.jp/kegg/rest/keggapi.html