API Overview

The Parallèle API provides RESTful endpoints for fetching content from your workspace.

Base URL

All API requests should be made to:

https://parallele.ai/api/public

Authentication

All endpoints require the x-api-key header with your workspace API key:

curl https://parallele.ai/api/public/content?locale=en \
  -H "x-api-key: prl_your_api_key"

Available Endpoints

Endpoint	Description
`GET /content`	Fetch content strings
`GET /content/preview`	Preview content strings (with drafts)
`GET /pages`	List published pages
`GET /pages/:slug`	Get a single page
`GET /collections`	List all collections
`GET /collections/:slug`	List items in a collection
`GET /collections/:slug/:itemSlug`	Get a single collection item
`GET /blog`	List published blog posts
`GET /blog/:slug`	Get a single blog post
`GET /menus/:slug`	Get a navigation menu

Common Parameters

Locale Filtering

Most endpoints accept a locale parameter:

# Fetch French content
GET /api/public/content?locale=fr
 
# Fetch English pages
GET /api/public/pages?locale=en

If not specified, the workspace's default locale is used.

All Locales

Some endpoints support fetching content in all locales:

# Get pages in all locales
GET /api/public/pages?allLocales=true

Pagination

Collection and blog endpoints support pagination:

# Get 10 items, starting from offset 20
GET /api/public/collections/testimonials?limit=10&offset=20

Response Format

All responses are JSON objects. Successful responses include the requested data:

{
  "content": {
    "hero.title": "Welcome",
    "hero.subtitle": "Build faster"
  },
  "locale": "en",
  "count": 2
}

Error responses include an error field:

{
  "error": "Collection not found"
}

HTTP Status Codes

Code	Description
200	Success
400	Bad request (invalid parameters)
401	Unauthorized (invalid or missing API key)
404	Not found
429	Rate limit exceeded
500	Server error

Site Metadata

Many endpoints include site metadata in the response:

{
  "site": {
    "name": "My Website",
    "domain": "example.com",
    "defaultLocale": "fr",
    "locales": [
      { "code": "fr", "name": "French", "nativeName": "Français", "isDefault": true },
      { "code": "en", "name": "English", "nativeName": "English", "isDefault": false }
    ]
  }
}

This is useful for building locale switchers and navigation.

API Overview

On this page