The CLUE API offers programmatic access to annotations and perturbational signatures in the CMap L1000 dataset via a collection of HTTP-based RESTful web services. These services support complex queries via simple HTTP GET requests that can be executed in a web browser or any programming language. If you are using a web browser to display results, it is best to add your favorite JSON viewer add-on or plugin. The results are returned as standard JSON objects. Click on the links on the side for usage instructions and examples. API requests is based on the loopback framework syntax.
Registration is required to obtain a user-specific API key. If you already have a clue account and you are signed in, click on your name in the upper right corner, then click on "Account Settings" to find your API Key. The examples below use a limited demonstration key.
The cell service returns cell line information.
The gene service returns meta-information for measured and inferred genes in the CMap L1000 dataset.
The profile service returns meta-information for profiles in the CMap L1000 dataset.
The pert service returns meta-information for perturbagens in the CMap L1000 dataset.
The plate service returns plate information.
The sig service returns meta-information for signatures in the CMap L1000 dataset.
The PCL service returns meta-information for perturbational classes in the CLUE dataset.
Therep_fda_exclusivity service returns information about the exclusivity period of a given drug. This information was obtained from the FDA Orange Book publication.
Therep_drug_moa service returns information about the mechanism of action of a drug.
Therep_fda_orange-book_term service returns information describing abbreviations used in the Orange Book.
Therep_fda_patent service returns information about the patent of a given drug extracted from the Orange Book.
Therep_sample service returns information about the purity, chemical structure, source, and various textual identifiers of the compound.
Therep_drug service returns information about drug synonyms, clinical status, corresponding FDA Orange Book ingredient(s), and external database identifiers.
Therep_drug_indication service returns information about the indications and disease areas for approved drugs.
Therep_fda_product service returns information about a product extracted from the FDA Orange Book publication.
Therep_drug_target service returns information about the gene target of a compound.
The CLUE API playground allows end consumers to visualize and interact with the API's resources/services.
After you have clicked on the link above, you will reach the CLUE API Explorer page. From here, you want to add your personal API Key. You can do so by clicking on the "Edit API Key" button.
You will notice that there is already an API key there. You want to replace that with your own. To find your personal API Key, head over to clue.io and log in to your account. Click on your username and copy and paste the string under the heading "API Key" and paste it in the CLUE API Explorer.
Now, you can interact with the API’s services. For instance, you can click on a field, such as "pert" and a drop down menu will display all of its API endpoints.
To view more, you can click on "GET/perts" for an expansion of additional operations.
This expansion allows you to search in the parameters. Let’s say that you want to query the compound sirolimus. You can do so by typing in this syntax:
Click "Try it out!" to submit this query request.
You will then get a Response Body that shows the information available for your query.