Linking Your Website to BioCyc.org Objects
We encourage interested parties to create links to BioCyc objects from other web sites. You may link to a BioCyc object directly by BioCyc object ID, or indirectly by a substring or EC number search.
Linking by Object ID
Linking by BioCyc object ID is the best strategy when you wish to hard-code a link to a specific object page. The easiest way to get the object ID is to just go to the the web page that you want to link to and copy the URL from there. The URL format is:
You can also specify a gene for the object ID to instruct the genome browser to expand to a particular gene:
Indirect linking is the best strategy when you do not know the BioCyc object ID. This might be the case if a query is being generated dynamically, rather than as a hard-coded link. Indirect queries may return: (a) no objects, in which case a message appears to that effect, (b) one object, in which case the object is displayed, or (c) more than one object, in which case a list of matching objects is displayed. The number of objects returned by an indirect query may change as the data in the EcoCyc KB changes.
There are currently four types of indirect queries: queries by substring, queries by EC number, queries by UniProt identifier and queries by Accession number.
The URL format for substring and EC number queries is identical:
where <ORGID> is as above, and <type> is one of COMPOUND, REACTION, ENZYME, GENE, or PATHWAY for substring searches, and either REACTION or ENZYME for EC number searches. <query-string> is either the substring or the EC number to search for. If your substring contains spaces, replace the spaces in the URL with +'s (you may also omit spaces and hyphens altogether, as they will not affect substring matching).
The format of the URL for UniProt identifier queries is:
where <ORGID> is as above, and <query-string> is the UniProt-id to search for.
The format of the URL for Accession queries is:
where <ORGID> is as above, and <query-string> is the Accession number to search for.
The following example URLs show the different ways of linking to entries in EcoCyc and MetaCyc.
Object ID Examples
Indirect Linking Examples