Bots and integrations

This page groups the main starting points for building bots on top of the Militant API.

Included example

• Keyword Relay Bot

The example bot:

• polls the timeline with posts.php
• filters configured keywords
• relays matches to a private inbox with messages.php
• keeps a state.json file to avoid duplicates

Useful use cases

• local watch on mobilization keywords
• moderation or anti-spam assistance
• alert relay to an operator account
• simple bridge to another internal system

Useful endpoints for bots

• auth.php: login and token refresh
• posts.php: timeline reading and posting
• comments.php: automated replies
• messages.php: private messages
• notifications.php: notification polling
• search.php: keyword search
• reports.php: moderation and reports

Good practices

• use a dedicated bot account
• keep privileges minimal
• store credentials outside the code
• keep local state to prevent duplicate actions
• always start with a dry-run mode

Read next

• SDK guide
• Main documentation
• First call

---