Developers

Build integrations, bots, and apps on top of xNotify with our REST API.

API Status: Currently in private beta. Request access to join the waitlist.

API overview

The xNotify API is a RESTful JSON API with OAuth 2.0 authentication. Rate limits are generous — 300 requests/minute for standard apps, 1,000/minute for approved partners.

Posts

Create, read, update, and delete posts. Search by hashtag, user, or keyword. Stream real-time posts via WebSocket.

Users

Look up profiles, followers, following lists. Manage blocks and mutes programmatically.

Notifications

Read notification feeds, mark as read, and subscribe to real-time notification streams.

Communities

List communities, read community feeds, manage membership and moderation tools.

Quick start

Authenticate with OAuth 2.0 and make your first API call:

curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://api.xnotify.io/v1/me

Response:

{
  "id": "usr_abc123",
  "username": "yourname",
  "display_name": "Your Name",
  "followers_count": 1247,
  "verified": true
}

SDKs

JavaScript/TypeScript — npm install @xnotify/sdk
Python — pip install xnotify
Swift — Swift Package Manager support
Kotlin — Maven Central

All SDKs are open source and available on GitHub.

Webhooks

Subscribe to events (new followers, mentions, DMs) and receive HTTP POST callbacks to your server. Webhooks are signed with HMAC-SHA256 for verification.

Rate limits

Standard apps: 300 requests/minute
Approved partners: 1,000 requests/minute
Enterprise: Custom limits available

Rate limit headers are included in every response: X-RateLimit-Remaining and X-RateLimit-Reset.

Get started

Ready to build? Email developers@xnotify.io to request API access. Include a brief description of what you're building.