Leveraging STRING and STITCH APIs for White Paper Insights: A Structured Approach

a-string-stitch-apis.md

Leveraging STRING and STITCH APIs for White Paper Insights: A Structured Approach

This document provides a structured approach to utilizing the STRING and STITCH APIs for retrieving protein-protein and chemical-protein interaction data, enriching the findings of your white paper on drug response assessment in lung cancer, particularly in the context of TP53 and RB1 pathways.

Understanding the APIs

• STRING (Search Tool for the Retrieval of Interacting Genes/Proteins):
  STRING is a database and web resource dedicated to protein-protein interactions, including both known and predicted interactions. It integrates data from multiple sources, such as experimental repositories, computational prediction methods, and public text collections.

• STITCH (Search Tool for Interactions of Chemicals):
  STITCH is a database and web resource that integrates various sources of information on chemical-protein interactions, helping to understand how chemicals affect biological systems.

Both APIs utilize similar structures for query construction and offer a range of output formats for analysis.

API Query Construction: A Step-by-Step Guide

1. Define Your Research Question:
   What specific biological processes, pathways, or interactions are you interested in exploring? (e.g., How does TP53 mutation status impact sensitivity to MDM2 inhibitors?)

2. Identify Key Proteins and Chemicals:
   List the gene names of the proteins and Chemical IDs (CIDs) of the chemicals relevant to your research question. Ensure that the identifiers you collect are up-to-date and double-checked for accuracy, as gene names and chemical IDs can occasionally be updated. You can find these identifiers using resources like:

   • Proteins:
     • HGNC (HUGO Gene Nomenclature Committee): https://www.genenames.org/
     • UniProt: https://www.uniprot.org/
     • NCBI Gene: https://www.ncbi.nlm.nih.gov/gene/
   • Chemicals:
     • PubChem: https://pubchem.ncbi.nlm.nih.gov/
     • STITCH: https://stitch.embl.de/

3. Choose the Appropriate API and Method:

   • STRING: Use for protein-protein interaction networks and functional enrichment analysis.
     • Network Visualization: https://string-db.org/api/image/network
     • Interaction Partners: https://string-db.org/api/tsv/interaction_partners
     • Functional Enrichment: https://string-db.org/api/tsv/enrichment
   • STITCH: Use for chemical-protein interactions and their impact on networks.
     • Interactors: http://stitch.embl.de/api/tsv/interactors
     • Network Visualization: http://stitch.embl.de/api/image/network

4. Construct Your Query:
   Using the chosen API endpoint and method, structure your query with the following parameters:

   • Required:
     • identifiers: A URL-encoded list (%0a as a separator) of gene names and/or CIDs.
     • species: Species identifier (e.g., 9606 for Homo sapiens).
   • Optional:
     • required_score: Confidence score threshold (higher values indicate higher confidence).
     • network_flavor: Type of network visualization (e.g., "confidence", "actions").
     • limit: Maximum number of results to return.
     • add_white_nodes: (STRING only) Adds nodes of interacting proteins not in your initial query.

   Note: Some parameters like add_white_nodes are specific to STRING and may not be available in STITCH. Always verify the availability of parameters with the latest API documentation:

   • STRING API Documentation: https://string-db.org/help/api/
   • STITCH API Documentation: http://stitch.embl.de/cgi/api

5. Execute Your Query:
   Paste the constructed URL into your web browser or use a tool like cURL to retrieve the data. For more complex analyses or automation, consider using scripting languages like Python with libraries such as requests or urllib.

6. Analyze and Interpret the Output:

   • Network Visualizations:
     Analyze the nodes (proteins/chemicals) and edges (interactions) for patterns and insights. Consider customizing network visualizations with tools like Cytoscape for more detailed presentations.
   • TSV Files:
     Parse the data to identify key interactions, scores, and supporting evidence. Pay attention to confidence scores and evidence types when interpreting interactions.

Example Use Cases and Queries

1. Visualizing Pathway Impact of TP53 Status on Drug Response

• Research Question:
  How does TP53 mutation status influence the efficacy of MDM2 inhibitors?

• API/Methods:

  • STRING: Network Visualization, Functional Enrichment
  • STITCH: Interactors, Network Visualization

• Example Queries:

  STRING (Network Visualization):

  https://string-db.org/api/image/network?identifiers=TP53%0aMDM2%0aCDKN1A%0aBAX&species=9606&network_flavor=confidence&required_score=900

  Note: The parameter add_color_nodes is not standard in the STRING API. If you wish to highlight specific nodes, consider using add_node_color or post-process the image using visualization tools.

  STITCH (Interactors):

  http://stitch.embl.de/api/tsv/interactors?identifiers=CID11326957%0aMDM2%0aTP53&species=9606&required_score=700

  (CID11326957 = Nutlin-3, an MDM2 inhibitor)

  STITCH (Network - Exploring Resistance):

  http://stitch.embl.de/api/image/network?identifiers=CID11326957%0aMDM2%0a[Potential_Resistance_Protein]&species=9606&network_flavor=actions&required_score=700

  Note: Replace [Potential_Resistance_Protein] with the actual gene name identified from further analysis.

2. Identifying Synergistic Drug Combinations

• Research Question:
  Can we identify potential synergistic drug combinations by targeting pathways enriched in cells resistant to CDK4/6 inhibitors?

• API/Methods:

  • STRING: Functional Enrichment
  • STITCH: Interactors, Network Visualization

• Example Queries:

  STRING (Enrichment - Identifying Resistant Pathways):

  https://string-db.org/api/tsv/enrichment?identifiers=[List_of_Proteins_Upregulated_in_Resistant_Cells]&species=9606

  Note: Ensure that your list of proteins is accurate and derived from reliable experimental data.

  STITCH (Interactors - Finding Drugs Targeting the Pathway):

  http://stitch.embl.de/api/tsv/interactors?identifiers=[Key_Protein_in_Resistant_Pathway]&species=9606&required_score=700

  STITCH (Network - Visualizing Combination Effects):

  http://stitch.embl.de/api/image/network?identifiers=CID5330286%0a[CID_Drug_Targeting_Resistant_Pathway]&species=9606&network_flavor=actions&required_score=700

  (CID5330286 = Palbociclib, a CDK4/6 inhibitor)

  Note: Replace [CID_Drug_Targeting_Resistant_Pathway] with the actual CID of the drug identified from your STITCH interactor analysis.

Interpreting Results for Your White Paper

• Connect the Dots:
  Relate the API findings to your research questions. Do the identified interactions support or contradict your hypotheses?

• Visualize Your Findings:
  Incorporate network visualizations from STRING and STITCH to illustrate key pathways, drug interactions, and potential resistance mechanisms. Customizing these visualizations with tools like Cytoscape can enhance the presentation.

• Provide Context:
  Explain the biological significance of your findings. How do they contribute to the broader understanding of drug response and resistance in lung cancer?

General Suggestions

• API Updates:
  Since APIs can evolve, verify parameters and endpoints with the latest documentation:

  • STRING API Documentation: https://string-db.org/help/api/
  • STITCH API Documentation: http://stitch.embl.de/cgi/api

• Error Handling:
  Implement error checking in your queries to handle cases where identifiers might not return results.

• Data Integration:
  When combining data from STRING and STITCH, ensure consistent identifier usage and consider cross-referencing IDs if necessary.

• Ethical Considerations:
  If your research involves patient data or sensitive information, ensure compliance with ethical guidelines and data protection regulations.

Conclusion

By following this structured approach and leveraging the power of STRING and STITCH APIs, you can generate compelling evidence to support the findings and insights presented in your white paper. Ensure that you keep up-to-date with the latest API changes, verify parameters, and interpret your results within the biological context to enrich your research on drug response assessment in lung cancer.

---

Final Note: The above changes incorporate the suggestions provided, ensuring accuracy and up-to-date usage of API parameters. This refined guide should assist you in effectively utilizing the STRING and STITCH APIs for your research.

b-string-api-queries-vr2-paper.md

Leveraging STRING Database API Queries to Support VR2 Paper Findings

Introduction

This document outlines key use cases for STRING database API queries that support the findings of the VR2 paper on drug response assessment in lung cancer, with a focus on TP53 and RB1 pathways. These queries are designed to elucidate sensitivity and resistance mechanisms in cancer cells, particularly in the context of S' and ΔS' metrics.

Key Use Cases and Queries

1. TP53 Pathway and Drug Response Network

Purpose: To visualize the interaction network of p53 and its key regulators in relation to drug response pathways.

Query:

https://string-db.org/api/image/network?identifiers=TP53%0aMDM2%0aCDKN1A%0aBAX%0aPUMA%0aATM%0aATR%0aCHEK1%0aCHEK2&species=9606&network_flavor=confidence&add_color_nodes=1st_shell:red&required_score=900

Relevance: This query helps in understanding how mutations in TP53 and its regulatory network might influence drug sensitivity patterns observed through S' and ΔS' analyses.

2. RB1 and Cell Cycle Regulation Network

Purpose: To explore the interaction network of RB1 with cell cycle regulators and CDK inhibitors.

Query:

https://string-db.org/api/image/network?identifiers=RB1%0aE2F1%0aCDK4%0aCDK6%0aCCND1%0aCDKN2A&species=9606&network_flavor=confidence&add_color_nodes=1st_shell:blue&required_score=900

Relevance: This network visualization supports the analysis of how RB1 mutations affect cell cycle regulation and response to CDK4/6 inhibitors, as reflected in the S' values.

3. Aurora Kinase and RB1 Interaction Partners

Purpose: To identify high-confidence interaction partners of Aurora Kinases and RB1, relevant to observed sensitivity in RB1-mutated lung cancer.

Query:

https://string-db.org/api/tsv/interaction_partners?identifiers=AURKA%0aAURKB%0aRB1&species=9606&required_score=900

Relevance: This query provides data on potential mechanisms of sensitivity to Aurora Kinase inhibitors in RB1-mutated cells, supporting the interpretation of ΔS' values.

4. MDM2-TP53 Axis and Drug Resistance

Purpose: To analyze the MDM2-TP53 regulatory network and its implications for drug resistance.

Query:

https://string-db.org/api/image/network?identifiers=MDM2%0aTP53%0aMDM4%0aUSP7%0aCDKN2A&species=9606&network_flavor=confidence&add_color_nodes=1st_shell:green&required_score=900

Relevance: This network helps in understanding resistance mechanisms to MDM2 inhibitors in TP53-mutated cells, as observed in S' and ΔS' analyses.

5. RAS-MEK-ERK and PI3K-AKT-mTOR Pathway Integration

Purpose: To visualize the integration of RAS-MEK-ERK and PI3K-AKT-mTOR pathways in the context of TP53 and RB1.

Query:

https://string-db.org/api/image/network?identifiers=KRAS%0aBRAF%0aMAP2K1%0aMAPK1%0aPIK3CA%0aAKT1%0aMTOR%0aTP53%0aRB1&species=9606&network_flavor=confidence&add_color_nodes=1st_shell:yellow&required_score=900

Relevance: This integrated network supports the analysis of differential drug responses based on TP53 and RB1 status across multiple signaling pathways.

6. Functional Enrichment Analysis of Key Proteins

Purpose: To perform functional enrichment analysis on proteins identified as significant in S' and ΔS' analyses.

Query:

https://string-db.org/api/tsv/enrichment?identifiers=TP53%0aRB1%0aMDM2%0aE2F1%0aCDK4%0aAURKA%0aBRAF%0aAKT1&species=9606

Relevance: This analysis helps in identifying overrepresented biological processes and pathways among the proteins most relevant to observed drug response patterns.

Conclusion

These STRING API queries provide valuable data and visualizations to support the findings presented in the VR2 paper. They offer insights into the molecular mechanisms underlying the observed S' and ΔS' values, helping to elucidate sensitivity and resistance patterns in lung cancer cells with various genetic backgrounds, particularly focusing on TP53 and RB1 mutations.

The networks and interaction data generated by these queries can be used to:

1. Corroborate experimental findings
2. Generate hypotheses about mechanisms of drug action
3. Identify potential biomarkers for drug response
4. Guide future experimental designs for validation studies

By integrating these network analyses with the S' and ΔS' metrics, the paper can provide a more comprehensive understanding of the complex interplay between genetic mutations, signaling pathways, and drug responses in lung cancer.

c-stitch-api-queries-vr2-paper.md

Leveraging STITCH Database API Queries for VR2 Paper Drug-Protein Interactions

Introduction

This document outlines key use cases for STITCH database API queries to complement the STRING analysis and further support the VR2 paper findings. These queries will focus on protein-chemical interactions, providing insights into drug mechanisms, off-target effects, and chemical-induced pathway perturbations relevant to the S' and ΔS' metrics in lung cancer.

Key Use Cases and Queries

1. Aurora Kinase Inhibitors and Their Targets

Purpose: To visualize the interaction network of Aurora Kinase inhibitors with their protein targets and related proteins.

Query:

http://stitch.embl.de/api/image/network?identifiers=CID100216824%0aAURKA%0aAURKB%0aAURKC%0aRB1&species=9606&network_flavor=actions&required_score=700

Relevance: This query helps in understanding the specificity and potential off-target effects of Aurora Kinase inhibitors, supporting the interpretation of their efficacy in RB1-mutated lung cancers as observed through S' values.

2. CDK4/6 Inhibitors in the Context of the RB Pathway

Purpose: To explore the interaction network of CDK4/6 inhibitors with their targets and other components of the RB pathway.

Query:

http://stitch.embl.de/api/image/network?identifiers=CID11707110%0aCDK4%0aCDK6%0aRB1%0aE2F1%0aCCND1%0aCDKN2A&species=9606&network_flavor=actions&required_score=700

Relevance: This network visualization supports the analysis of how CDK4/6 inhibitors interact with the RB pathway, helping to explain differential responses in RB1 wild-type versus mutant cells as reflected in ΔS' values.

3. MDM2 Inhibitors and p53 Pathway Interactions

Purpose: To analyze the interaction network of MDM2 inhibitors with p53 and related proteins in the p53 pathway.

Query:

http://stitch.embl.de/api/image/network?identifiers=CID11327430%0aMDM2%0aTP53%0aCDKN1A%0aBAX%0aPUMA&species=9606&network_flavor=actions&required_score=700

Relevance: This query provides insights into how MDM2 inhibitors interact with the p53 pathway, supporting the interpretation of resistance mechanisms in TP53-mutated cells observed through S' and ΔS' analyses.

4. EGFR Inhibitors and Downstream Signaling Pathways

Purpose: To visualize the interaction network of EGFR inhibitors with EGFR and components of downstream signaling pathways.

Query:

http://stitch.embl.de/api/image/network?identifiers=CID123631%0aEGFR%0aKRAS%0aBRAF%0aPIK3CA%0aAKT1&species=9606&network_flavor=actions&required_score=700

Relevance: This network helps in understanding how EGFR inhibitors affect multiple signaling pathways, supporting the analysis of differential drug responses based on mutation status in the EGFR pathway.

5. Multi-Kinase Inhibitors and Their Diverse Targets

Purpose: To explore the interaction network of a multi-kinase inhibitor (e.g., Sorafenib) with its various protein targets.

Query:

http://stitch.embl.de/api/image/network?identifiers=CID216239%0aVEGFR2%0aRAF1%0aKIT%0aFLT3%0aPDGFRB&species=9606&network_flavor=actions&required_score=700

Relevance: This query illustrates the complex interactions of multi-kinase inhibitors, helping to interpret broad-spectrum effects observed in S' values across different genetic backgrounds.

6. Chemical-Protein Interaction Scores for Key Drugs

Purpose: To retrieve interaction scores between a set of drugs and their protein targets relevant to lung cancer.

Query:

http://stitch.embl.de/api/tsv/interactors?identifiers=CID123631%0aCID11707110%0aCID216239&species=9606&required_score=700

Relevance: This data can be used to correlate drug-target interaction strengths with observed S' values, potentially explaining variability in drug responses.

Conclusion

These STITCH API queries provide valuable data on protein-chemical interactions that complement our STRING-based protein-protein interaction analyses. By integrating this information, we can:

1. Elucidate direct mechanisms of drug action on target proteins
2. Identify potential off-target effects that may contribute to drug sensitivity or resistance
3. Understand how drugs perturb specific pathways, correlating with observed S' and ΔS' values
4. Explore how genetic mutations (e.g., in TP53 or RB1) may alter drug-protein interactions and subsequent cellular responses

Incorporating these protein-chemical interaction analyses will significantly enhance the VR2 paper by providing a more comprehensive understanding of the molecular basis for observed drug responses in lung cancer cells with various genetic backgrounds.