Skip to main content

Python client for iPTMNet REST API -

Project description

PTMnet is a bioinformatics resource for integrated understanding of protein post-translational modifications (PTMs) in systems biology context. It connects multiple disparate bioinformatics tools and systems of text mining, data mining, analysis and visualization tools, and databases and ontologies into an integrated cross-cutting research resource to address the knowledge gaps in exploring and discovering PTM networks.

Quick start

The API consists of functions that mirror the functionality of the iPTMNet rest api.


Retriving information for an entry with an iPTMnet ID - Q15796

import pyiptmnet.api as api

# get the information for Q15796 

Type : dictionary

  "uniprot_ac": "Q15796",
  "uniprot_id": "SMAD2_HUMAN",
  "protein_name": "Mothers against decapentaplegic homolog 2;",
  "gene_name": "SMAD2",
  "synonyms": [
  "organism": {
    "taxon_code": 9606,
    "species": "Homo sapiens",
    "common_name": "Human"
  "pro": {
    "id": "PR:Q15796",
    "name": "mothers against decapentaplegic homolog 2 (human)",
    "definition": "A smad2 that is encoded in the genome of human.",
    "short_label": "hSMAD2",
    "category": "organism-gene"


To search the iPTMnet database for entries related to the gene smad2, you can use the search function as follows.

import pyiptmnet.api as api
from pyiptmnet.enums import *

# search the database"smad2", Termtype.ProteinGeneName, Role.EnzymeOrSubstrate)

Type : dataframe

iptm_id protein_name gene_name synonyms organism_taxon_code organism_species organism_common_name substrate_role substrate_num enzyme_role enzyme_num ptm_dependent_ppi_role ptm_dep_ppi_num sites isoforms
O70436 Mothers against decapentaplegic homolog 2; Smad2 Madh2 10116 Rattus norvegicus Rat True 0 False 0 False 0 6 0
Q1W668 Mothers against decapentaplegic homolog 2; SMAD2 9913 Bos taurus Bovine True 0 False 0 False 0 4 0


To perform a bulk query for ptm enzymes on the database with a list of PTM sites in a csv file - sites.csv you can use get_ptm_enzymes_from_file function.

import pyiptmnet.api as api
from pyiptmnet.enums import *

# search the database

Type : dataframe

ptm_type site site_position score source pmid enz_name enz_id sub_name sub_id
Phosphorylation S2 2 2 HPRD 8898866,20068231 PRKCB P05771 ANXA2 P07355
Phosphorylation S7 7 4 HPRD,neXtPro 20166139,12773393,20089855,17924679,11438671 RPS6KA5 O75582 HMGN1 P05114
Phosphorylation T60 60 4 neXtProt,PSP 21355052,16081417 SGK1 O00141 WNK1 Q9H4A3

Citations of the underlying Sources

# Name Publication PubMed
1 HPRD Prasad, T. S. K. et al. (2009) Human Protein Reference Database - 2009 Update. Nucleic Acids Research. 37, D767-72. 18988627
2 phospho.ELM Dinkel H, Chica C, Via A, Gould CM, Jensen LJ, Gibson TJ, Diella F. Nucleic Acids Res. 2011 Jan;39(Database issue) 261-7. doi: 10.1093/nar/gkq1104. 21062810
3 p3DB Yao Q, Ge H, Wu S, Zhang N, Chen W, Xu C, Gao J, Thelen JJ, Xu D. (2013) P3DB 3.0: From plant phosphorylation sites to protein networks. Nucleic Acids Res 2013. 42(Database issue):D1206-D1213 24243849
4 PhosphoGrid Stark C, Breitkreutz BJ, Reguly T, Boucher L, Breitkreutz A, Tyers M. Biogrid: A General Repository for Interaction Datasets. Nucleic Acids Res. 2006; 34:D535-9. 16381927
5 PomBase Wood V, Harris MA, McDowall MD, Rutherford K, Vaughan BW, Staines DM, Aslett M, Lock A, Bähler J, Kersey PJ, Oliver SG. PomBase: a comprehensive online resource for fission yeast. Nucleic Acids Res. 2012;40(Database issue):D695-9. Epub 2011 22039153
6 neXtProt Gaudet P, Michel PA, Zahn-Zabal M, Britan A, Cusin I, Domagalski M, Duek PD, Gateau A, Gleizes A, Hinard V, Rech de Laval V, Lin JJ, Nikitin F, Schaeffer M, Teixeira D, Lane L, Bairoch A. The neXtProt knowledgebase on human proteins: 2017 update. Nucleic Acids Res. 2017; 45(D1):D177-D182 doi:10.1093/nar/gkw1062 27899619
7 Signor Perfetto L, Briganti L, Calderone A, Cerquone Perpetuini A, Iannuccelli M, Langone F, Licata L, Marinkovic M, Mattioni A, Pavlidou T, Peluso D, Petrilli LL, Pirrò S, Posca D, Santonico E, Silvestri A, Spada F, Castagnoli L, Cesareni G. SIGNOR: a database of causal relationships between biological entities. Nucleic Acids Res. 2016;44(D1):D548-54. doi: 10.1093/nar/gkv1048 26467481
8 dbSNO Chen YJ, Lu CT, Su MG, Huang KY, Ching WC, Yang HH, Liao YC, Chen YJ, Lee TY. dbSNO 2.0: a resource for exploring structural environment, functional and disease association and regulatory network of protein S-nitrosylation. Nucleic Acids Res. 2015;43(Database issue):D503-11. doi: 10.1093/nar/gku1176. 25399423
9 PhosphoSitePlus Hornbeck PV, Zhang B, Murray B, Kornhauser JM, Latham V, Skrzypek E. PhosphoSitePlus, 2014: mutations, PTMs and recalibrations. Nucleic Acids Res. 2015;43(Database issue):D512-20. doi: 10.1093/nar/gku1267. 25514926
10 PhosPhAt Durek P, Schmidt R, Heazlewood JL, Jones A, Maclean D, Nagel A, Kersten B, Schulze WX. PhosPhAt: the Arabidopsis thaliana phosphorylation site database. An update. Nucleic Acids Res. 38: D828-D834 (2010) 17984086
11 UniProt The UniProt Consortium. UniProt: the universal protein knowledgebase Nucleic Acids Res. 45: D158-D169 (2017) 27899622
12 PRO Natale DA, Arighi CN, Blake JA, Bona J, Chen C, Chen SC, Christie KR, Cowart J, D'Eustachio P, Diehl AD, Drabkin HJ, Duncan WD, Huang H, Ren J, Ross K,Ruttenberg A, Shamovsky V, Smith B, Wang Q, Zhang J, El-Sayed A, Wu CH. Protein Ontology (PRO): enhancing and scaling up the representation of protein entities. Nucleic Acids Res.2017;45(D1):D339-D346. doi: 10.1093/nar/gkw1075. 27899649
13 RLIMS-P Torii M, Li G, Li Z, Oughtred R, Diella F, Celen I, Arighi CN, Huang H, Vijay-Shanker K, Wu CH. RLIMS-P: an online text-mining tool for literature-based extraction of protein phosphorylation information. Database (Oxford).2014. pii: bau081. doi: 10.1093/database/bau081. 25122463
14 eFIP Wang Q, Ross KE, Huang H, Ren J, Li G, Vijay-Shanker K, Wu CH, Arighi CN. Analysis of Protein Phosphorylation and Its Functional Impact on Protein-Protein Interactions via Text Mining of the Scientific Literature. Methods Mol Biol. 2017;1558:213-232. doi: 10.1007/978-1-4939-6783-4_10. 28150240
15 SGD Paskov KM, Wong ED, Karra K, Engel SR, Cherry JM. Curated protein information in the Saccharomyces genome database. Database (Oxford). 2017 Jan 1;2017(1). doi: 10.1093/database/bax011 28365727
16 Biomuta Dingerdissen HM, Torcivia-Rodriguez J, Hu Y, Chang TC, Mazumder R, Kahsay R. BioMuta and BioXpress: mutation and expression knowledgebases for cancerbiomarker discovery. Nucleic Acids Res. 2018 Jan 4;46(D1):D1128-D1136. doi:10.1093/nar/gkx907 30053270

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyiptmnet-0.1.5.tar.gz (8.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page