How do I export comments and messages with the Rypl API?
Updated
Send your Rypl key in the Authorization header to https://app.rypl.is/api/v1/comments or /messages, filter by time, channel, platform or sentiment, and follow next_cursor until it is null. To get a key, connect Other app or API in Settings under MCP and API Keys.
curl "https://app.rypl.is/api/v1/comments?period=last_7_days&timezone=Europe/Berlin" \
-H "Authorization: Bearer rypl_xxxxxxxx…"It works the same from your computer, a scheduled script on a server or a data warehouse.
What comes back
A shortened example, one row:
{
"data": [
{
"id": "…",
"type": "comment",
"platform": "instagram",
"created_at": "2026-11-10T09:30:00Z",
"text": "Do you ship to Austria?",
"channel": { "id": "…", "name": "Lumen Candles" },
"author": { "id": "…", "name": "anna.k" },
"analysis": { "language": "en", "sentiment": "neutral", "intent": "Question", "is_question": true },
"hidden": false,
"ai_reply": { "text": "Yes, we ship to Austria in 3 to 5 days.", "response_seconds": 14 }
}
],
"next_cursor": "…"
}Each row also carries the post it was left on, Rypl's moderation when it was hidden or deleted (by what and why), and the rule that handed it to you, if one did. The full list of fields is in What endpoints does the Rypl API have?
Paging
- Rows come newest first, 100 per page by default and up to 200 with
limit. - Send
cursor=<next_cursor>with the same other parameters for the next page.next_cursor: nullmeans you have everything.
Choosing the rows
| Parameter | Example |
|---|---|
period and timezone | period=yesterday&timezone=America/New_York; also today, last_7_days, last_30_days |
since, until | since=2026-11-01&until=2026-11-07, both days included |
updated_since | Rows that changed in Rypl since then: analysed, replied to, hidden or deleted |
channel, platform | A channel id from /channels; facebook, instagram or tiktok |
sentiment, intent | sentiment=negative, intent=complaint |
view | An Inbox tab: negative, ai_replies, hidden_or_deleted, unanswered_questions and more |
from_page=false | Only customers' rows, without your Page's own |
Keeping a copy up to date
Export once with since, then ask for updated_since=<the time of your last export>. That brings new rows and the ones Rypl has changed since: newly analysed, replied to, hidden or deleted.
Limits
- 120 requests a minute per connection. Over that the API answers
429with aRetry-Afterheader: wait that many seconds. - Times are ISO 8601, for example
2026-11-01or2026-11-01T09:30:00Z. - The data can be a few seconds behind your Inbox.
Related
Rules by an app
Only if you switch it on. It can add and edit rules and banned words and change the mode. It can never set anything to delete.
API reference
Channels, comments, messages, posts, AI replies, a summary for a period, Needs attention, agents and rules, plus moderating comments and editing rules.