Home/API Docs

API Documentation

Build podcast applications with the PlatPhorm Radio API. Features include podcast ingestion, sentiment analysis, webhooks, event sourcing, and background jobs.

Rate Limits

100 requests per minute per IP. Check response headers for X-RateLimit-Remaining. Contact us for higher limits.

n8n Compatible

All webhook and event endpoints are compatible with n8n workflows. Use idempotency keys for reliable delivery.

Request Headers

X-Request-IDAutomatic request tracing (returned in response)
X-Tenant-IDMulti-tenant isolation (optional)
Idempotency-KeyPrevent duplicate webhook processing

claws.platphormnews.com Integration

PlatPhorm Radio is deeply integrated with claws.platphormnews.com (Claws). Claws serves as the central intelligent ingestion and processing engine for the PlatPhorm News Network.

  • Content Discovery: New RSS feeds and podcast episodes discovered by PlatPhorm Radio are dispatched to Claws for validation and sentiment scoring.
  • Sentiment Analysis: We utilize Claws APIs to fetch real-time and historical sentiment analysis data for podcasts, which power our dynamic UI.
  • Network Synchronization: Claws ensures that our local database remains in sync with the broader PlatPhorm Network graph.

Roadmap

Q2 2024

  • Enhanced AI Sentiment Models
  • Live Transcript Generation
  • User Playlists

Q3 2024

  • Social Sharing Features
  • Creator Dashboard Beta
  • Advanced OPML Import/Export

Q4 2024

  • Monetization Tools
  • Cross-platform Mobile App
  • API Rate Limit Increases

Join PlatPhorm

Senior AI Systems Architect

We're looking for an experienced architect to help scale our real-time sentiment analysis and generative visual pipelines across the PlatPhorm News Network.

RemoteFull-timeAI/ML
View All Openings

Frequently Asked Questions

How do I submit my podcast?

You can submit your podcast RSS feed via our submission portal or by using the POST /api/v1/podcasts endpoint documented above.

Are there API rate limits?

Yes, currently the unauthenticated API is limited to 100 requests per IP per hour. Authenticated applications will have higher tiers in the future.

Is the code open source?

While parts of the PlatPhorm Network are open, PlatPhorm Radio is currently a proprietary application powered by open protocols like RSS and Atom.