Public API

Access Surbias stories programmatically. Free, no auth required for read endpoints.

Base URL

https://surbias.com/api

Endpoints

GET /api/posts

List published posts.

Query parameters:

• page (number) — Page number, default 1
• category (string) — Filter by category: career, business, education, relationships, health, financial, other
• locale (string) — Filter by language: en, es, de, fr, pt
• sort (string) — Sort by: recent (default), hot, popular
• q (string) — Search query (min 2 chars)

Response:

{ "posts": [...], "page": 1, "totalPages": 5, "total": 100 }

GET /api/posts/[id]/comments

Get comments for a specific post.

GET /feed.xml

RSS 2.0 feed. Optional ?locale= parameter.

GET /api/og/[id]

Auto-generated Open Graph image (SVG) for a post.

GET /api/embed/[id]

Embeddable HTML widget for a post. Use in an iframe.

Rate Limits

Public endpoints are rate-limited. Please be reasonable — max ~60 requests/minute.

Terms

By using the API you agree to our Terms of Service. Attribution appreciated but not required.