Skip to main content
guidesproductai

How to Get Facebook, Instagram and TikTok Ad Comments Through an API or MCP (2026)

By Bogdan Slawinski12 min read
How to Get Facebook, Instagram and TikTok Ad Comments Through an API or MCP (2026)
The short answer

There are two ways to get ad comments out of Facebook, Instagram and TikTok. Build it yourself on each platform's API: Meta's Graph API for Facebook and Instagram, with a Meta app, Page permissions, App Review for Pages you don't own and a lookup to find the post behind every ad, and TikTok's API for Business for TikTok ads. You get the text and the author; whether a comment is a complaint, and why it was hidden, is yours to work out. Or use one Rypl key. The Rypl API returns comments from all three platforms, plus Facebook and Instagram DMs, in one format, already read for sentiment, intent and urgency, with what Rypl hid and why. The same key connects an AI app like Claude Code, Cursor or Gemini CLI through Rypl's MCP server, so you can ask "what are customers complaining about this week?" in plain words. It's on Pro and Ultra, and it can't reply or delete.

A customer asked us how to get their ad comments through an API. Rypl's API and MCP server went live on November 12, 2026, and this post covers both routes to the same comments: building it on the platforms' own APIs, and doing it with one Rypl key. The output below is real, from Rypl's demo account, a made-up candle shop called Lumen Candles.

Why get ad comments out of the inbox?

Comments are where buyers tell you, unasked, what is wrong with an ad, a product or an order. In an inbox they get answered one at a time. Outside it they become data you can count, rank and join with the rest of your numbers:

  • A weekly complaints digest without reading every thread.
  • The ad that draws the most complaints, next to what it costs.
  • Comments joined with spend and orders in your data warehouse, by ad and post id.
  • A check of what your AI agent promised customers, so someone keeps those promises.
  • An audit of what was hidden and why, for your team or a client.

How to get comments from the Facebook and Instagram API yourself

Meta's Graph API returns the comments on Page posts and Instagram media, ads included, once your app holds the right permissions and a Page access token. Expect to set up five things:

  1. A Meta app and a Page access token with pages_read_user_content, which, in Meta's words, "allows your app to read user generated content on the Page, such as posts, comments, and ratings", plus pages_read_engagement for the Page's own posts (Meta permissions reference).
  2. Instagram permissions: instagram_basic and instagram_manage_comments (IG Media comments).
  3. App Review, if the app reads Pages you don't own or manage, and Business Verification, which Meta requires for every app that asks for Advanced Access.
  4. The post behind each ad. An ad's comments sit on its post, often one that was never published on the Page. The ad creative's effective_object_story_id is "the ID of a page post to use in an ad, regardless of whether it's an organic or unpublished page post"; for Instagram it's effective_instagram_media_id (Ad Creative reference).
  5. Paging. GET /{post-id}/comments returns top-level comments by default; filter=stream adds the replies, and Meta warns that posts with tens of thousands of comments can hit limits while paging (Comments reference). Instagram returns at most 50 comments per request, and Meta notes that "comments cannot be filtered by timestamp".

What comes back is the comment's text, author and time. Whether it is a complaint, a question about shipping or spam, and why a comment was hidden, is left to you.

How to get TikTok ad comments through the API

TikTok's API for Business lists the comments on your ads with GET /open_api/v1.3/comment/list/. It takes the ad account's advertiser_id, a time window (start_time, end_time) and a TikTok access token, and returns 10 comments per page by default (TikTok's Comments API). Its token, paging and data format differ from Meta's, so a script that covers all three platforms talks to two different APIs.

How to get all three through the Rypl API

If your Facebook Pages, Instagram accounts and TikTok ad accounts are connected to Rypl, one key returns their comments in one format, with Rypl's analysis and moderation attached. Facebook and Instagram DMs come through the same key.

Getting the key takes about a minute. In Rypl, open Settings, find MCP and API Keys, click Connect, pick Other app or API, name the connection and click Create key. The window shows the REST API address and the key, once.

The Rypl window for another app or script: the MCP server address, the REST API address and the key, which is shown only once

Then ask for the last week of comments:

curl "https://app.rypl.is/api/v1/comments?period=last_7_days" \
  -H "Authorization: Bearer rypl_xxxxxxxx…"

This is one row of the real answer from the demo account, with the long texts cut short:

{
  "type": "comment",
  "platform": "instagram",
  "created_at": "2026-11-12T19:48:00Z",
  "text": "Ordered Fig & Cedar 9 days ago and it still says \"label created\"…",
  "post": {
    "kind": "ad",
    "url": "https://www.instagram.com/p/DFig8kCedar/"
  },
  "analysis": {
    "sentiment": "negative",
    "intent": "Complaint",
    "urgency": "high",
    "severity": 3
  },
  "hidden": false,
  "ai_reply": {
    "text": "So sorry for the wait, Harper. Launch orders ship in waves…",
    "agent": { "name": "Mila" },
    "response_seconds": 36
  }
}

The comment comes with the ad it was left on, what it wants and how urgent it is, and what the agent answered and how fast. A hidden comment also says why: banned words, one of your rules, the tone filter or the spam filter.

To keep a copy in a warehouse up to date, export once with since, then ask for updated_since the time of your last run: that brings new rows and the ones Rypl has changed since, newly replied to or hidden. For counts, /summary adds them up for a period. On the demo account's last seven days it gave 20 comments: 9 negative, 8 of them complaints, 4 questions and 3 spam comments, all 3 hidden.

The full list of filters and fields is in What endpoints does the Rypl API have?, and the export recipe in How do I export comments and messages with the Rypl API?

Ask an AI assistant about your comments (MCP)

MCP, the Model Context Protocol, lets an AI app call tools on another service. Rypl's MCP server gives an assistant the same reads as the API, as tools it picks by itself: list comments and messages, count them for a period, rank the ads that draw complaints, list what needs your attention. You ask in plain words and it chooses the calls.

Connecting Claude Code takes two lines in a terminal. The second one checks the connection, and the Rypl window turns Connected a few seconds later:

The Rypl window for Claude Code: the two-line command with the key hidden, and the Connected state suggesting a first question

Cursor and VS Code install it with one button, Gemini CLI with the same two lines, and any other MCP client takes the server address and the key. The claude.ai and ChatGPT connectors aren't supported yet. Step by step: How do I connect Claude Code, Cursor or another AI app to Rypl?

This is what Claude Code answered on the demo account, asked "What are customers complaining about this week?". It made five calls, among them a summary by intent, the week's negative comments and the posts ranked by negative comments, and wrote, in part:

Most complaints this week are about slow shipping on the Fig & Cedar launch. Volume is low: 20 comments since Nov 6 and no DMs. 9 of the 20 are negative and 8 are complaints.

1. Late Fig & Cedar orders (4 complaints, Instagram launch ad) […] dana_k: "Two weeks and nothing. Not ordering again." No reply yet. Your "Orders late more than 10 days" rule flagged it for you to answer.

[…]

Promises the AI agent (Mila) made that you should check […] "Ships tomorrow" and free shipping on the next order for Sam. "Ships tomorrow" for Harper, plus "we just sent the tracking link to your email". […] If nobody on your team is actually doing these things, they'll turn into the next round of complaints.

The last part is the one a person scrolling an inbox tends to miss: the complaints are about shipping, not the candle, and the replies made commitments someone has to keep. Questions that work the same way:

  • "Which ad gets the most complaints?"
  • "What did Rypl hide yesterday and why?"
  • "Which questions has nobody answered?"
  • "Who left a phone number?"
  • "How fast does my agent reply?"

More of them, and what each one reads, in What can I ask an AI app about my comments?

What a connected app can and can't do

Every connection gets its own key and its own permissions, chosen when you create it: comments, direct messages and settings to read, all channels or a few, and when access ends.

Rypl's choices for a connection: comments, direct messages and settings to read, with moderating comments and changing moderation rules switched off

  • Read what you allowed, on the channels you picked.
  • Moderate comments, if you switch it on: hide and unhide comments on the platform, and mark them as reviewed.
  • Change moderation rules, if you switch it on: add and edit your Global rules and banned words. Never to delete anything.
  • No replies and no deletes. Replies come from your Rypl agent, with your brand voice, knowledge base and reply rules, so they stay the same whichever app asks. A delete can't be undone, so an app hides instead.

The key is shown once and opens only the API, not your dashboard. Disconnect an app in Settings and its key stops working at once. The details: What can a connected app read and change?

Which route should you pick?

Platform APIsRypl API and MCP
PlatformsMeta for Facebook and Instagram, TikTok separatelyFacebook, Instagram and TikTok ads, one format
SetupDeveloper apps, permissions, App Review for Pages you don't ownOne key from Settings, about a minute
Comments on adsLook up the post behind each ad firstIncluded, marked as ads
Sentiment, intent, urgencyNot includedOn every row
Why a comment was hiddenNot includedOn every hidden row
AI assistantBuild your own toolsMCP server for Claude Code, Cursor, VS Code, Gemini CLI
PriceFree, plus the engineering timeRypl Pro ($49/month) or Ultra ($89/month), trial included

The platform APIs are the way to go if you need only the raw text from your own Pages and have someone to build and keep the integration. If you want the comments already sorted into complaints, questions and spam, from three platforms at once, or you want to ask an assistant about them this afternoon, the Rypl key gets you there in a minute.

Plans and limits

The API and MCP server are on Rypl's Pro and Ultra plans, the 7-day trial included. An account can hold up to 10 connections, each with its own key, and each connection can make 120 requests a minute. Everything else is in the API and AI apps docs.

To try it on your own comments, start a free trial, connect your Facebook Page, Instagram account or TikTok ad account, and create a key under MCP and API Keys.

Frequently asked questions

Does Facebook have an API for reading comments?
Yes. Meta's Graph API returns the comments on a Page's posts with GET /{post-id}/comments, once your app holds a Page access token with the pages_read_user_content permission. Comments on an ad live on the post behind the ad, which you find through the ad creative's effective_object_story_id. Reading Pages you don't own or manage needs App Review, and Advanced Access needs Business Verification. The API returns the text and the author, not whether the comment is a complaint or why it was hidden.
How do I export Instagram comments?
Through Meta's Graph API, with the instagram_basic and instagram_manage_comments permissions: GET /{ig-media-id}/comments returns up to 50 comments per request, top-level only unless you expand replies, and Meta notes that comments cannot be filtered by timestamp. For ads, the ad creative's effective_instagram_media_id points to the right media. Rypl's API exports Instagram comments next to Facebook and TikTok ones, filtered by date, sentiment or intent, with since, until and updated_since.
Is there an MCP server for Facebook and Instagram comments?
Rypl has one at https://app.rypl.is/api/mcp. It speaks Streamable HTTP and takes a Rypl key in the Authorization header. Through it an AI app such as Claude Code, Cursor, VS Code with GitHub Copilot or Gemini CLI can list comments and direct messages from Facebook and Instagram and comments on TikTok ads, count them for a period, rank the ads that draw complaints and read the Needs attention list. It is on the Pro and Ultra plans.
Can Claude or ChatGPT read my Facebook comments?
Claude Code can, through Rypl's MCP server: connect it in Rypl under Settings, MCP and API Keys, and ask in plain words, for example "what are customers complaining about this week?". Cursor, VS Code with GitHub Copilot and Gemini CLI connect the same way. The claude.ai and ChatGPT connectors are not supported yet, because they can't send a key in a header. You choose which channels and what kind of data each app may read.
Can I reply to comments through the Rypl API?
No. The Rypl API and MCP server read comments and messages, and with your permission they can hide, unhide and mark comments as reviewed or change your moderation rules. They can't reply and can't delete. Replies come from your Rypl agent, which answers with your brand voice, knowledge base and reply rules, so every reply follows the same rules whichever app you use.
All posts

Turn RYPL on before the next comment lands.

Describe your business, connect your Pages, and RYPL takes it from there.

Turn RYPL on

7 days free, $0 today, cancel any time.