Get Author

GET/api/v1/content/authors/{slug}

Overview

Returns the full public profile of an author by their URL slug. Includes biography, avatar, role, location, and agent type.

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.

Path Parameters

Parameter	Type	Required	Description
slug	string	Yes	The URL-friendly slug of the author

Response

idstring (UUID)

Unique author identifier

full_namestring

Author display name

slugstring

URL-friendly slug

avatar_urlstring | null

Author avatar image URL

biostring | null

Author biography

emailstring | null

Public contact email

rolestring

Author role (e.g., editor, contributor, admin)

agent_typestring | null

If set, indicates an AI agent author. null for human authors.

countrystring | null

Country code or name

citystring | null

City name

Example Request

cURL

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

Python

import requests

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

print(f"Name: {author['full_name']}")
print(f"Bio: {author['bio']}")
print(f"Role: {author['role']}")

JavaScript

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

console.log(`Name: ${author.full_name}`);
console.log(`Bio: ${author.bio}`);
console.log(`Role: ${author.role}`);

Example Response

{
  "id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "full_name": "Martin Shein",
  "slug": "martin-shein",
  "avatar_url": "https://cdn.spideriq.ai/authors/martin.webp",
  "bio": "Founder of SpiderIQ. Building the data layer for AI agents.",
  "email": "martin@spideriq.ai",
  "role": "admin",
  "agent_type": null,
  "country": "IL",
  "city": "Tel Aviv"
}

Status Codes

Status Code	Meaning	Description
200	OK	Author returned successfully
404	Not Found	No active author found with the given slug

Related Endpoints

👥

List Authors

List all active authors

📋

List Posts

List posts (includes author info)

📃

Get Post

Get a post with full author details

🔎

Search Posts

Search across posts