Site Settings

GET/api/v1/content/settings

Overview

Returns site-wide settings for the resolved client site, including branding (name, tagline, logos), theme (colors), social links, and analytics configuration.

Authentication

info

No authentication required - Client is resolved from the X-Content-Domain header, which the Cloudflare Worker sets automatically based on the request domain.

Headers

Header	Type	Required	Description
X-Content-Domain	string	Yes	The domain used to resolve the client tenant. Automatically set by the CF Worker; set manually for external frontend integrations.

Response

site_namestring

Site display name

site_taglinestring | null

Site tagline or subtitle

favicon_urlstring | null

Favicon URL

primary_colorstring | null

Primary brand color (hex, e.g., #4F46E5)

logo_dark_urlstring | null

Logo URL for dark backgrounds

logo_light_urlstring | null

Logo URL for light backgrounds

copyright_textstring | null

Footer copyright text

social_linksobject | null

Social media links (keys are platform names, values are URLs)

google_analytics_idstring | null

Google Analytics measurement ID (e.g., G-XXXXXXXXXX)

Example Request

cURL

curl -s "https://spideriq.ai/api/v1/content/settings" \
  -H "X-Content-Domain: your-domain.com"

Python

import requests

resp = requests.get(
    "https://spideriq.ai/api/v1/content/settings",
    headers={"X-Content-Domain": "your-domain.com"}
)
settings = resp.json()

print(f"Site: {settings['site_name']}")
print(f"Tagline: {settings['site_tagline']}")
print(f"Primary Color: {settings['primary_color']}")

JavaScript

const resp = await fetch(
  "https://spideriq.ai/api/v1/content/settings",
  { headers: { "X-Content-Domain": "your-domain.com" } }
);
const settings = await resp.json();

console.log(`Site: ${settings.site_name}`);
console.log(`Tagline: ${settings.site_tagline}`);
document.title = settings.site_name;

Example Response

{
  "site_name": "SpiderIQ",
  "site_tagline": "The data layer for AI agents",
  "favicon_url": "https://cdn.spideriq.ai/brand/favicon.ico",
  "primary_color": "#4F46E5",
  "logo_dark_url": "https://cdn.spideriq.ai/brand/logo-dark.svg",
  "logo_light_url": "https://cdn.spideriq.ai/brand/logo-light.svg",
  "copyright_text": "2026 SpiderIQ. All rights reserved.",
  "social_links": {
    "twitter": "https://twitter.com/spideriq",
    "linkedin": "https://linkedin.com/company/spideriq",
    "github": "https://github.com/spideriq"
  },
  "google_analytics_id": "G-XXXXXXXXXX"
}

Status Codes

Status Code	Meaning	Description
200	OK	Settings returned successfully

Related Endpoints

bars

Navigation

Get navigation menus

files

List Pages

List published pages

📋

List Posts

List published posts

🗂️

Sitemap

Auto-generated sitemap