Skip to main content
Rypl

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: null means you have everything.

Choosing the rows

ParameterExample
period and timezoneperiod=yesterday&timezone=America/New_York; also today, last_7_days, last_30_days
since, untilsince=2026-11-01&until=2026-11-07, both days included
updated_sinceRows that changed in Rypl since then: analysed, replied to, hidden or deleted
channel, platformA channel id from /channels; facebook, instagram or tiktok
sentiment, intentsentiment=negative, intent=complaint
viewAn Inbox tab: negative, ai_replies, hidden_or_deleted, unanswered_questions and more
from_page=falseOnly 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 429 with a Retry-After header: wait that many seconds.
  • Times are ISO 8601, for example 2026-11-01 or 2026-11-01T09:30:00Z.
  • The data can be a few seconds behind your Inbox.

On this page