Multi-dimensional filtering. Section-level precision. 15+ structured outputs. Built for enterprise AI teams.
# Simple story retrieval curl -X POST https://api.synorb.com/stories \ -H "api-key: YOUR_KEY" \ -H "secret: YOUR_SECRET" \ -d '{ "stream_id": 889, "published_date_from": "2025-01-01" }' # Returns complete stories
# Filter by entity dimensions curl -X POST https://api.synorb.com/stories \ -H "api-key: YOUR_KEY" \ -H "secret: YOUR_SECRET" \ -d '{ "stream_id": 889, "filters": [ {"key": "Topics", "value": "AI"} ] }' # Returns only AI-related content
# Extract specific sections only curl -X POST https://api.synorb.com/stories \ -H "api-key: YOUR_KEY" \ -H "secret: YOUR_SECRET" \ -d '{ "stream_id": 889, "body_sections": [ "Key Insights", "Signals" ] }' # Returns only insights + signals
# Surgical multi-dimensional extraction curl -X POST https://api.synorb.com/stories \ -H "api-key: YOUR_KEY" \ -H "secret: YOUR_SECRET" \ -d '{ "stream_id": 889, "filters": [ {"key": "Topics", "value": "AI"}, {"key": "people", "value": "Marc Andreessen"} ], "body_sections": ["Portfolio Mentions"], "published_date_from": "2025-09-01" }' # Precision-targeted intelligence
Complete API specifications with enhanced filtering and surgical extraction capabilities
Headers only - no query parameters required.
| Header | Type | Description |
|---|---|---|
| api-key | string | Your API key from account dashboard |
| secret | string | Your API secret for authentication |
{
"user_id": 429,
"usage": {
"quota": 1000, // Monthly allocation
"usage": 3252, // Stories consumed
"overage": 2252, // Beyond quota
"quota_reset_date": "2025-10-15"
}
}{
"streams": [
{
"id": 889,
"title": "Andreessen Horowitz Insights",
"description": "VC insights, portfolio updates...",
"purpose": "Track venture perspectives...",
"home_domain": "economics-business-work",
"cross_domains": ["engineering-technology"],
"primary_entity": {
"name": "Andreessen Horowitz",
"type": "org",
"role": "publisher"
}
}
]
}| Field | Type | Description |
|---|---|---|
| id | integer | Stream identifier for detail queries |
| home_domain | string | Primary domain classification |
| cross_domains | array | Secondary domains this stream appears in |
| Parameter | Type | Required | Description |
|---|---|---|---|
| streamid | integer | Required | Stream ID from catalog |
{
"stream_id": 889,
"title": "Andreessen Horowitz Insights",
// 15+ structured body sections (stream-specific)
"body_sections": [
"Overview", "Key Insights", "Notable Quotes",
"Actionable Takeaways", "Announcement",
"Key Details", "Big Picture", "Key Arguments",
"Signals", "Entities Mentioned", "Links",
"Portfolio Mentions", "Risks & Watchpoints",
"Resources Mentioned", "Timestamps"
],
// Multi-dimensional filters (stream-specific)
"filters": [
{
"key": "Topics",
"allowed": ["AI", "Crypto", "Biotech", "Enterprise"]
},
{
"key": "people",
"allowed": ["Marc Andreessen", "Ben Horowitz"]
},
{
"key": "content_type",
"allowed": ["Blog Post", "Podcast", "Tweet Thread"]
}
],
// Activity metrics
"activity": {
"7d_count": 12,
"30d_count": 48,
"90d_count": 156
}
}Always call /stream first to discover available filters and body sections for that stream. Each stream has unique filter dimensions and section structures. Use this metadata to construct precise /stories queries.
{
"stream_id": 889, // Required
"published_date_from": "2025-08-01", // Optional
"published_date_to": "2025-10-03", // Optional
"page_num": 0, // Default: 0
"page_size": 100, // Max: 200
// Section extraction (empty = all)
"body_sections": [
"Key Insights",
"Signals",
"Portfolio Mentions"
],
// Multi-dimensional filtering
"filters": [
{"key": "Topics", "value": "AI"},
{"key": "people", "value": "Marc Andreessen"}
]
}| Parameter | Type | Required | Description |
|---|---|---|---|
| stream_id | integer | Required | Target stream identifier |
| body_sections | array | Optional | Sections to extract (empty = all 15 sections). Use /stream to discover available sections. |
| filters | array | Optional | Multi-dimensional filters [{key, value}]. Use /stream to discover filter dimensions. |
| published_date_from | string | Optional | Start date (YYYY-MM-DD format) |
| page_size | integer | Optional | Results per page (max: 200) |
{
"stories": [
{
"story_id": 1126730,
"published_date": "2025-09-23",
"filters": [
{"key": "Topics", "allowed": ["AI", "Crypto"]},
{"key": "people", "allowed": ["Ben Horowitz"]}
],
"story": {
"body": "# Title\n\n## Key Insights\n..."
}
}
],
"pagination": {
"total_count": 28,
"next": null,
"prev": null
}
}Combine body_sections + filters for precision targeting. Example: Extract only "Portfolio Mentions" section from AI-related stories by Marc Andreessen. Filters are stream-specific - always check /stream first.
Native SDKs, enterprise patterns, and production recipes available in your dashboard
All code examples include your personal API key and secret pre-filled and ready to use
Production-ready libraries with your credentials pre-configured
Production implementations for competitive intelligence and risk monitoring
Surgical extraction techniques and production optimization strategies
Start building with Synorb's machine-native content infrastructure
🎉 30 Day Recall • 1,000 stories/month • No credit card required