Get Post

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

Overview

Returns a single published post by its URL slug. Includes the full body content (Tiptap JSON), SEO fields, related posts, and author details. Each request increments the post's view count.

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 post

Response

idstring (UUID)

Unique post identifier

slugstring

URL-friendly slug

titlestring

Post title

bodyobject

Full post content as Tiptap JSON

excerptstring

Short excerpt / summary

tldr_summarystring | null

Optional TL;DR summary

cover_image_urlstring | null

URL of the cover image

featured_image_altstring | null

Alt text for the cover image

statusstring

Always published

published_atstring

ISO 8601 publication timestamp

authorobject

Author object with id, full_name, slug, avatar_url, bio

tagsstring[]

Array of tag names

categoriesarray

Array of category objects with id, name, slug

related_postsarray

Array of related post summaries (id, slug, title, excerpt, cover_image_url)

reading_timeinteger

Estimated reading time in minutes

view_countinteger

Total view count (incremented by this request)

is_featuredboolean

Whether the post is featured

seo_titlestring | null

Custom SEO title (falls back to post title)

seo_descriptionstring | null

Custom SEO meta description

og_image_urlstring | null

Open Graph image URL

Example Request

cURL

curl -s "https://spideriq.ai/api/v1/content/posts/how-to-scrape-google-maps" \
  -H "X-Content-Domain: your-domain.com"

Python

import requests

resp = requests.get(
    "https://spideriq.ai/api/v1/content/posts/how-to-scrape-google-maps",
    headers={"X-Content-Domain": "your-domain.com"}
)
post = resp.json()

print(f"Title: {post['title']}")
print(f"Author: {post['author']['full_name']}")
print(f"Views: {post['view_count']}")
print(f"Tags: {', '.join(post['tags'])}")

JavaScript

const resp = await fetch(
  "https://spideriq.ai/api/v1/content/posts/how-to-scrape-google-maps",
  { headers: { "X-Content-Domain": "your-domain.com" } }
);
const post = await resp.json();

console.log(`Title: ${post.title}`);
console.log(`Author: ${post.author.full_name}`);
console.log(`Body nodes: ${post.body.content.length}`);

Example Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "slug": "how-to-scrape-google-maps",
  "title": "How to Scrape Google Maps at Scale",
  "body": {
    "type": "doc",
    "content": [
      {
        "type": "heading",
        "attrs": { "level": 2 },
        "content": [{ "type": "text", "text": "Introduction" }]
      },
      {
        "type": "paragraph",
        "content": [{ "type": "text", "text": "Google Maps is one of the richest sources..." }]
      }
    ]
  },
  "excerpt": "A step-by-step guide to extracting business data from Google Maps.",
  "tldr_summary": "Use SpiderMaps to extract businesses at scale, then enrich with SpiderSite.",
  "cover_image_url": "https://cdn.spideriq.ai/blog/maps-guide-cover.webp",
  "featured_image_alt": "Google Maps scraping workflow diagram",
  "status": "published",
  "published_at": "2026-03-15T09:00:00Z",
  "author": {
    "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."
  },
  "tags": ["google-maps", "scraping", "seo"],
  "categories": [
    { "id": "cat-001", "name": "Tutorials", "slug": "tutorials" }
  ],
  "related_posts": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "slug": "email-verification-guide",
      "title": "Email Verification: The Complete Guide",
      "excerpt": "How to verify emails at scale...",
      "cover_image_url": "https://cdn.spideriq.ai/blog/verify-cover.webp"
    }
  ],
  "reading_time": 8,
  "view_count": 1244,
  "is_featured": true,
  "seo_title": "How to Scrape Google Maps at Scale | SpiderIQ",
  "seo_description": "Learn how to extract business data from Google Maps using SpiderIQ's API.",
  "og_image_url": "https://cdn.spideriq.ai/blog/maps-guide-og.webp"
}

Status Codes

Status Code	Meaning	Description
200	OK	Post returned successfully
404	Not Found	No published post found with the given slug

Related Endpoints

📋

List Posts

List all published posts

⭐

Featured Posts

List featured posts

🔎

Search Posts

Full-text search across posts

👥

List Authors

List active authors