Social Media API Best Practices

Battle-tested patterns for integrating social media APIs, from scheduling 1M+ posts across 13 platforms.

Installation

npx skills add mikipalet/skills/social-media-api-best-practices

All 13 Platforms Covered

What's Included

• OAuth & Authentication - All flows including AT Protocol for Bluesky
• Rate Limiting - Multi-tier handling, exponential backoff
• Media Uploads - Streaming, chunked uploads, format requirements
• Error Handling - Complete error code mappings for all platforms
• Platform Quirks - Large integer IDs, character counting, encryption
• Code Snippets - Copy-paste ready TypeScript examples

Usage

Once installed, Claude Code will automatically apply these best practices when working on social media integrations:

/social-media-api-best-practices

Example Prompts

• "Help me implement Twitter OAuth with PKCE"
• "Why is my Instagram post returning error 2207052?"
• "How do I post to Bluesky using AT Protocol?"
• "What's the rate limit for TikTok uploads?"
• "How do I encrypt media for Snapchat?"

Key Insights

Instagram 2207051 Edge Case

Instagram's anti-spam sometimes returns "blocked" but actually publishes the post. Always verify by checking recent media before treating as failure.

Twitter's Three-Tier Rate Limits

Twitter has app-level, user-level, AND endpoint-specific limits. Check all three headers to avoid unexpected blocks.

Bluesky AT Protocol

Bluesky doesn't use OAuth. It uses DIDs (Decentralized Identifiers) and PDS (Personal Data Servers). Rich text requires byte-offset facets.

Snapchat Encryption

Snapchat requires AES-256-CBC encryption of media before upload. You must generate random key/IV and include them in the upload request.

Reddit User-Agent

Reddit strictly enforces descriptive user agents. Generic agents like "axios/1.0" will be blocked.

Contributing

Found a new platform quirk? PRs welcome!

License

MIT

---

Maintained by Late - Social Media Scheduling API for Developers