API Documentation

XApp provides REST API endpoints for managing posts and authentication.

Auth API

GET/api/auth/twitter

Initiates the OAuth flow with X (Twitter).

GET/api/auth/twitter/callback

Handles the OAuth callback from X.

code: The authorization code from X.

state: The CSRF protection state.

Redirects to the homepage with a session cookie.

GET/api/auth/me

Fetches the current user's information.

POST/api/auth/logout

Logs out the user and clears the session.

GET/api/posts

Fetches a list of collected posts.

limit: Number of posts to return (default: 50).

offset: The starting position for pagination (default: 0).

collection: Filter by collection ID.

search: Search within post content.

POST/api/collections/search

Starts a collection of posts based on a search query.

POST/api/collections/user

Starts a collection of posts from a specific user.

GET/api/collections

Fetches a list of all collections.

status: Filter by status (pending, in_progress, completed, failed).

limit: Number of collections (default: 50).

offset: The starting position for pagination.

GET/api/collections/:id/progress

Fetches the progress of a specific collection.

DELETE/api/collections/:id

Deletes a collection and all its associated posts.