Public API — ABCOMICS

A free, read-only API over the same public data shown on the Databases browser — projects, samples, runs, analyses, and non-genomic records. Only records already marked Public are ever returned.

Get a key

Free, issued immediately — a key only grants read access to data that is already public.

Name *

Email *

Organization

What will you use it for?

Authentication

Pass your key as a header on every request:

curl -H "X-API-Key: YOUR_KEY" "https://abcomics.org/api/v1/data.php?type=projects"

Or as a query parameter (?api_key=YOUR_KEY) if headers aren't convenient for your tool.

Endpoint

GET /api/v1/data.php?type={projects|samples|runs|analyses|nongenomic}

Parameter	Description
`type`	Required. One of `projects`, `samples`, `runs`, `analyses`, `nongenomic`.
`id`	Fetch a single record by its ID instead of a list.
`q`	Free-text search across the fields this type exposes.
`country`	Filter by `geographic_location_country` (samples, nongenomic).
`organism`	Filter by organism/pathogen (samples, nongenomic).
`page`, `per_page`	Pagination — `per_page` max 100, default 50.

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://abcomics.org/api/v1/data.php?type=samples&country=Senegal&per_page=20"

{
  "status": "success",
  "type": "samples",
  "page": 1,
  "per_page": 20,
  "total": 42,
  "total_pages": 3,
  "items": [ { "sample_id": "SMPAB00001", "..." : "..." } ]
}

Rate limits

500 requests per hour, per key. Going over returns HTTP 429 with a Retry-After header.

Questions

Ask our forum, or the chat assistant on the homepage — or email contact@abcomics.org.