Skip to main page content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Access keys NCBI Homepage MyNCBI Homepage Main Content Main Navigation

Webs Services

COG

  1. Get all COGs:
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?format=json
  2. Filter COGs by gene tag: MK0280
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?gene=MK0280
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?gene=MK0280&format=json
  3. Filter COGs by COG ID tag: COG0003
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0003
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0003&format=json
  4. Filter COGs by assembly ID: GCA_000007185.1
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?assembly=GCA_000007185.1
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?assembly=GCA_000007185.1&format=json
  5. Filter COGs by organism name: Nitrosopumilus_maritimus_SCM1
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?organism=Nitrosopumilus_maritimus_SCM1
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?organism=Nitrosopumilus_maritimus_SCM11&format=json
  6. Filter COGs by taxid: 1229908
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?taxid=1229908
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?taxid=1229908&format=json
  7. Filter COGs by Taxonomic Category: ACTINOBACTERIA
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?category=ACTINOBACTERIA
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?category=ACTINOBACTERIA&format=json
  8. Filter COGs by Taxonomic Category taxid: 651137
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cat_taxid=651137
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cat_taxid=651137&format=json
  9. Filter COGs by Protein name: AJP49128.1
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?protein=AJP49128.1
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?protein=AJP49128.1&format=json

COG combined queries

The search keywords (cog, assembly, organism, taxid, category, cat_taxid and protein) can be combined to filter the COG lists.

  1. Filter COGs by COG id and Taxonomy Categories: COG0004 and CYANOBACTERIA
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0004&category=CYANOBACTERIA
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0004&category=CYANOBACTERIA&format=json
  2. Filter COGs by COG id and organism: COG0004 and Escherichia_coli_K-12_sub_MG1655
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0004&organism=Escherichia_coli_K-12_sub_MG1655
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cog/?cog=COG0004&organism=Escherichia_coli_K-12_sub_MG1655&format=json

COG Definitions

  1. Get all COG Definitions:
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/?format=json
  2. Get specific COG Definitions by COG: COG0003
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/?cog=COG0003
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/?cog=COG0003&format=json
  3. Get specific COG Definitions by name: Thiamin-binding stress-response protein YqgV, UPF0045 family
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/?name=Thiamin-binding%20stress-response%20protein%20YqgV,%20UPF0045%20family
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/cogdef/?name=Thiamin-binding%20stress-response%20protein%20YqgV,%20UPF0045%20family&format=json

Taxonomic Categories

  1. Get all Taxonomic Categories:
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/taxonomy/
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/taxonomy/?format=json
  2. Get specific Taxonomic Category by name: ALPHAPROTEOBACTERIA
    Web API: https://ncbi.nlm.nih.gov/research/cog/api/taxonomy/?name=ALPHAPROTEOBACTERIA
    JSON Format: https://ncbi.nlm.nih.gov/research/cog/api/taxonomy/?name=ALPHAPROTEOBACTERIA&format=json