BrainStars (B*)



The database has a REST-like Web API interface for accessing from your Web applications. This document shows how to access the database via our Web API.

We have the following Web APIs:

You can get contents in HTML, JSON, YAML, and so on. (See below)

Search API

Search API is for keyword search and is based on Tokyo Manifesto and TogoWS REST interface.

URL for retrieving a list of hit entries[/(offset),(limit)]


If the result has at least one hit entries, a list of entry IDs is returned in text/plain format (each line corresponds to each hit entry). If not, 404 Not found error code is returned. The output format can be changed to JSON, and so on (see below). "offset,limit" can be used to retrieve a part of hit entries. If "offset,limit" is not given, all hits are returned.

URL for retrieving the count of hit entries


The count of hit entries is returned in text/plain format


List API

List API is for retrieving a list of entries, such as genes in a specific gene category.[/(category)[/(subcategory)[/...]]]/(offset),(limit)[/(category)[/(subcategory)[/...]]]/all[/(category)[/(subcategory)[/...]]]/count

You can specify "type" in the following list:

Marker gene candidates (marker)

[List of entries]:{high,low}/(region)/(offset),(limit)
[Count of entries]:{high,low}/(region)/count

{high,low}: "high": highly expressed regions, "low": low expressed regions.
(region): CNS region.

Multi-state genes (multistate)

[List of entries]:{high,up,low,down}/(region)/(offset),(limit)
[Count of entries]:{high,up,low,down}/(region)/count

{high,up,low,down}: "high": high state regions, "up": up state regions, "low": low state regions, "down": down state regions.
(region): CNS region.

One-state genes (onestate)

[List of entries]:,(limit)
[Count of entries]:

Inferred connections among CNS regions by neurotransmitter/neurohormone (ntnh)

[List of entries]:{high,low}/(ligand-region)/(receptor-region)/(offset),(limit)
[Count of entries]:{high,low}/(ligand-region)/(receptor-region)/count

{high,low}: "high": high state regions, "up": up state regions.
(ligand-region): Ligand CNS region.
(receptor-region): Receptor CNS region.

gene family / categories (genefamily)

[List of entries]:,(limit)
[Count of entries]:

(category): gene family / category name (keyword): keyword. If no keyword search required, make this omited or blank.


Entry API

Entry API is for obtaining information (annotation, expressions, links) about each entry


Content type

How to designate a content type

You can get information in another format rather than default format (default: text/plain in search/list API; text/html in entry API).

  1. Using a "content-type" parameter in the query string of the URI.
  2. Using an "Accept" header of your HTTP request.
    Example: curl -H "Accept: application/json"
    Example: wget --header "Accept: application/json"

Supported content type

Go to the documents page
Copyright © 2009 RIKEN Center for developmental Biology.