API reference

Read-only catalog endpoints and data exports.

Use a registered service credential with audience api:public-read and permission public_api.read. Set WW_SERVICE_TOKEN on your server and send Authorization: Bearer $WW_SERVICE_TOKEN. Contact World Wide for access; account sign-in and x-api-key do not authenticate v1. Keep credentials out of browser code and URLs.

API overview

The v1 API and data export share limits of 50 requests per minute per IP and 100 per principal. A 429 response includes Retry-After: 60; wait before retrying. GET and HEAD require authentication; OPTIONS describes supported methods. Responses use Cache-Control: private, no-store. Cross-origin browser access is not enabled.

For paginated v1 lists, page starts at 1 and limit defaults to 20 (maximum 100); (page - 1) × limit cannot exceed 100,000. Use only the parameters listed for an endpoint. Unknown or repeated parameters, empty values, invalid booleans, and unsupported filters return 400. Use domainId or domainSlug where supported, never both. A field filter includes every matching field tag. Data export uses offset pagination and its own limits below.

Examples are illustrative and show selected record fields with the actual response envelope. Field names and pagination differ by endpoint. The domains endpoint is unpaginated. For paginated lists without hasMore or hasNext, continue until a page is shorter than limit or empty. Pagination is not a snapshot: records can change between requests. No upload or mutation endpoint is part of this contract.

Errors

Errors are JSON objects with an error message; authorization failures also include code and requestId. Use HTTP status to classify failures. Edge/proxy errors may have a different body.

400: Invalid identifier, query, pagination or format. Correct the request before retrying.
401: Missing or invalid service credential, including an expired, revoked or wrong-audience credential.
403: The authenticated principal is not permitted to read the public API.
404: Unknown route or unavailable detail resource. Collection responses may instead be empty.
405: Unsupported method. Read the Allow response header.
429: Rate limit or shared admission unavailable. Wait for Retry-After (60 seconds).
500: The request could not be completed because of a server error.
503: An authentication, authorization or audit dependency is unavailable.

Endpoints

Catalog (read-only)

Conferences

Exports

Podcasts

Workshops

Domains

List active, published fields with discoverable public content, optionally with counts. The API names fields domains.

Auth: Service principal (Authorization: Bearer)

Request

GET/api/v1/domains

Parameters

includeCounts (boolean, query, 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.",
      "counts": {
        "seminars": 120,
        "conferences": 14,
        "jobs": 52,
        "grants": 39,
        "workshops": 8,
        "podcasts": 21
      }
    }
  ],
  "total": 1
}

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.