BrainStars (B*)

search:

Web API

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

http://poabf.brainstars.org/search/(query+string)[/(offset),(limit)]

output:

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

http://poabf.brainstars.org/search/(query+string)/count

output:

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

samples

List API

List API is for retrieving a list of entries, such as genes in a specific gene category.

http://poabf.brainstars.org/(type)[/(category)[/(subcategory)[/...]]]/(offset),(limit) http://poabf.brainstars.org/(type)[/(category)[/(subcategory)[/...]]]/all
http://poabf.brainstars.org/(type)[/(category)[/(subcategory)[/...]]]/count

You can specify "type" in the following list:

Marker gene candidates (marker)

[List of entries]: http://poabf.brainstars.org/marker/{high,low}/(region)/(offset),(limit)
[Count of entries]: http://poabf.brainstars.org/marker/{high,low}/(region)/count

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

Multi-state genes (multistate)

[List of entries]: http://poabf.brainstars.org/multistate/{high,up,low,down}/(region)/(offset),(limit)
[Count of entries]: http://poabf.brainstars.org/multistate/{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]: http://poabf.brainstars.org/onestate/(offset),(limit)
[Count of entries]: http://poabf.brainstars.org/onestate/count

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

[List of entries]: http://poabf.brainstars.org/ntnh/{high,low}/(ligand-region)/(receptor-region)/(offset),(limit)
[Count of entries]: http://poabf.brainstars.org/ntnh/{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]: http://poabf.brainstars.org/genefamily/(category)/(keyword)/(offset),(limit)
[Count of entries]: http://poabf.brainstars.org/genefamily/(category)/(keyword)/count

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

samples

Entry API

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

http://poabf.brainstars.org/probeset/(id)

samples

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.
    Example: http://poabf.brainstars.org/marker/high/LS?content-type=application/json
  2. Using an "Accept" header of your HTTP request.
    Example: curl -H "Accept: application/json" http://poabf.brainstars.org/marker/high/LS
    Example: wget --header "Accept: application/json" http://poabf.brainstars.org/marker/high/LS

Supported content type


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