API reference

Endpoint parameters and examples for the read-only v1 API. Every request requires a registered service credential with public_api.read permission.

Shared limits: 50 requests per minute per IP and 100 per service principal across all endpoints. A 429 response includes Retry-After. Pagination accepts positive integers, at most 100 items and an offset of 100,000. Unknown or repeated query parameters return 400. Responses are private and not cached; browser cross-origin access is not enabled.

API overview

Endpoints

Catalog (read-only)

Conferences

Domains

List active scientific domains (optionally with content counts).

Auth: Service principal (Authorization: Bearer)

Request

GET/api/v1/domains

Parameters

includeCounts (boolean, default true, allowed: true, false)

Include content counts per domain.

Responses

200 — Domain list

{
  "data": [
    {
      "id": "019b891c-b981-74dc-8f5c-87b1e1ec2c1e",
      "slug": "neuroscience",
      "name": "Neuroscience",
      "nickname": "Neuro",
      "description": "Research spanning cellular, systems, and computational neuroscience.",
      "sortOrder": 10,
      "counts": {
        "seminars": 120,
        "conferences": 14,
        "jobs": 52,
        "grants": 39
      }
    }
  ],
  "total": 1
}

401 — Missing service credential

{
  "error": "Authentication is required."
}

403 — Invalid service credential

{
  "error": "Authentication is required."
}

503 — Service unavailable

{
  "error": "Service unavailable"
}

Example

curl "https://world-wide.org/api/v1/domains" -H "Authorization: Bearer $WW_SERVICE_TOKEN"

Notes

Base URL is versioned under /api/v1 and served from world-wide.org (apex domain).

Need help?

Contact info@world-wide.org for API access and integration support.