Neuroscale for developers and agents

Everything neuroscale.ai publishes about Arbi, Aurora, and Athena is readable as structured data: a JSON API, an OpenAPI specification, and a markdown representation of every page. No key, no signup.

OpenAPI 3.1 specificationEvery operation, parameter, and response schema.llms.txtThe site index, written for language models.Agent instructionsWhen to use Neuroscale, and how to call it.SitemapEvery public URL on this site.

Authentication

There is none. Every endpoint below is public, read-only, and anonymous.

Send no credentials. An Authorization header is ignored.
Rate limit: 60 requests per minute per IP. Exceeding it returns 429 with a Retry-After header and the code rate_limited.
Responses are cacheable for 60 seconds at the edge. Please cache rather than poll.
This API exposes published website content only. It holds no candidate or customer data and cannot perform recruiting actions. For the Arbi product API, see docs.neuroscale.ai.

Endpoints

9 operations, all described in full at /openapi.json.

GET/api/v1/productslistProducts

List Neuroscale products

GET/api/v1/pricing/{product}getProductPricing

Get published pricing for a product

GET/api/v1/postslistBlogPosts

List published blog posts

GET/api/v1/posts/{slug}getBlogPost

Get one blog post with its body

GET/api/v1/releaseslistReleases

List Arbi releases

GET/api/v1/releases/{version}getRelease

Get one release by version

GET/api/v1/customerslistCustomerStories

List customer case studies

GET/api/v1/customers/{slug}getCustomerStory

Get one customer story with its narrative

GET/api/v1/searchsearchContent

Search all published content

Example requests

Every response is JSON. Lists share one envelope; single resources are returned directly.

# What does Neuroscale sell?
curl https://neuroscale.ai/api/v1/products

# What does Arbi cost?
curl https://neuroscale.ai/api/v1/pricing/arbi

# Find the right page before fetching it
curl "https://neuroscale.ai/api/v1/search?q=candidate+screening&limit=5"

# Read one blog post, body included, as JSON
curl https://neuroscale.ai/api/v1/posts/boolean-search-is-a-dead-end

# The same post as plain markdown
curl -H "Accept: text/markdown" https://neuroscale.ai/blog/boolean-search-is-a-dead-end

A list response looks like this:

{
  "object": "list",
  "url": "/api/v1/products",
  "count": 3,
  "data": [ { "object": "product", "id": "arbi", ... } ]
}

Errors

Every non-2xx response has the same shape. Branch on `code`, show `message`, act on `hint`.

{
  "error": "No published blog post matches that identifier.",
  "code": "not_found",
  "message": "No published blog post matches that identifier.",
  "hint": "Call listBlogPosts to see the slugs that exist.",
  "status": 404,
  "docs": "https://neuroscale.ai/developers#errors"
}

bad_requestThe request could not be read at all.

invalid_parameterOne parameter was missing, malformed, or out of range.

validation_failedThe payload parsed but failed validation; see `details`.

unauthorizedAuthentication is required and was not supplied.

forbiddenAuthenticated, but not allowed to do this.

not_foundNo resource matches that identifier.

method_not_allowedThe path exists but not for that HTTP method.

not_acceptableNo representation matches the `Accept` header.

payload_too_largeThe upload exceeded the size limit.

rate_limitedToo many requests; a `Retry-After` header gives the wait.

not_configuredThe feature is not enabled on this deployment.

upstream_errorA dependency failed. Safe to retry with backoff.

internal_errorSomething failed on our side.

Markdown instead of HTML

Every page on this site serves a markdown representation from the same URL, negotiated on the Accept header per acceptmarkdown.com.

curl -H "Accept: text/markdown" https://neuroscale.ai/pricing
# Content-Type: text/markdown; charset=utf-8
# Vary: Accept

Quality values and q=0 rejections are honoured; a request that accepts neither HTML nor markdown gets a 406.
Blog posts and releases also have permanent .md URLs — /blog/{slug}.md and /releases/{version}.md — for crawlers that send no Accept header.
A request for a page that does not exist returns a real 404 with a markdown body listing where to look next.

For autonomous agents

If you are an agent deciding whether this site can answer your question, read the instruction file first.

/agents.md — when to use Neuroscale, which endpoint answers which question, and what this site cannot tell you.
/llms.txt — the llmstxt.org index, with a link to the markdown twin of every piece of content.
/llms-full.txt — every post and release inlined in one file.

The future of recruiting is here.

Source

Screen

Sequence

Interview