Engagement

Beyond publishing, MADIAD Hub lets you act on the audience a profile has built — list recent media, read and reply to comments, send direct messages, and run AutoDM monitors that respond to new commenters automatically. Every call is scoped to one of your own profiles via profile_id.

To leave your own first comment automatically when a post publishes (a link or hashtags), use the post’s first_comment field instead — that’s part of publishing, not engagement.

Replying to and moderating comments is available on the Starter plan and above. Direct messages and AutoDM monitors are available on the Business plan and above, and each plan has a daily DM cap — exceeding it returns 429. Requests on a plan that does not include the feature return 403.

Action	Plan required
Read comments, list media	Every active plan
Reply publicly under a comment	Starter and above
Create a comment, delete a comment	Starter and above
Hide / like / pin a comment	Starter and above
Reply privately to a commenter	Business and above
Send a direct message, run an AutoDM monitor	Business and above
Reply to a Google review	Business and above

The inactive plan has no write actions at all. To see what your own plan includes, read GET /v1/usage: comments.included covers the comment actions, direct_messages.included covers messaging and review replies.

Direct messages and AutoDM are also subject to each platform’s own messaging limits (for example Instagram’s window for messaging a user who hasn’t messaged you recently). When a platform rejects a send, the reason surfaces in the response.

List recent media

Retrieve recent posts, reels, and videos across a profile’s connected accounts — useful for finding the media_id to read comments on.

curl "https://api.madiad.com/v1/engagement/media?profile_id=$PROFILE_ID&platform=instagram" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

This list resolves by the CONNECTED ACCOUNT, not by the Profile. If the Facebook (or LinkedIn) account you connected administers several Pages, the endpoint returns that account’s default Page — not the Page belonging to the Profile you asked for. Measured 2026-09-04. Instagram and Threads do filter correctly.You only ever see Pages your own account administers — never another customer’s data. But on a multi-Page account, check each item’s owner id before you use it. The response carries a scope_warning field saying the same thing.For post metrics scoped to the Profile, use GET /v1/analytics/posts.

Comments

Platforms — reading comments: Instagram · Facebook · YouTube · LinkedIn · TikTok. Threads, X, Pinterest, Reddit, Bluesky, Google Business and the credential channels are not covered.

Read the comments on a post. Pass platform and identify the post by post_id (the media id from the listing above) or post_url:

curl "https://api.madiad.com/v1/engagement/comments?profile_id=$PROFILE_ID&platform=instagram&post_id=$MEDIA_ID" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

Reply under a comment publicly, or send the commenter a private DM:

# Public reply
curl -X POST https://api.madiad.com/v1/engagement/comments/public-reply \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "comment_id": "'$COMMENT_ID'", "message": "Thanks for watching!" }'

# Private DM reply
curl -X POST https://api.madiad.com/v1/engagement/comments/reply \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "comment_id": "'$COMMENT_ID'", "message": "Sent you the link in DM 👀" }'

Both require profile_id, comment_id, and message.

Direct messages

Platforms: Instagram only. DMs and AutoDM are not available on any other channel.

Send a DM to a user by their platform-specific id, and list existing conversations. Both require a platform:

curl -X POST https://api.madiad.com/v1/engagement/dms/send \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "instagram", "recipient_id": "17841400000000000", "message": "Hi! Here's the discount code." }'

curl "https://api.madiad.com/v1/engagement/dms/conversations?profile_id=$PROFILE_ID&platform=instagram" \
  -H "Authorization: Bearer $MADIAD_API_KEY"

AutoDM monitors

An AutoDM monitor watches a post and automatically DMs anyone who comments — optionally only when their comment contains a trigger keyword.

AutoDM monitors are Instagram only, using Meta’s official Private Replies API. The monitor runs in the background and de-duplicates commenters automatically, so each person is messaged once.

curl -X POST https://api.madiad.com/v1/autodm/monitors \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "'$PROFILE_ID'",
    "post_url": "https://www.instagram.com/p/abc123/",
    "reply_message": "Here is the link you asked for: https://madiad.com/offer",
    "trigger_keywords": ["link", "info"]
  }'

The response returns a monitor_id. Manage the monitor with it:

Action	Request
Status	`GET /v1/autodm/monitors/{monitor_id}`
Activity logs	`GET /v1/autodm/monitors/{monitor_id}/logs`
Pause	`POST /v1/autodm/monitors/{monitor_id}/pause`
Resume	`POST /v1/autodm/monitors/{monitor_id}/resume`
Stop	`POST /v1/autodm/monitors/{monitor_id}/stop`
Delete	`DELETE /v1/autodm/monitors/{monitor_id}`

Field	Required	Description
`profile_id`	yes	The profile whose connected account runs the monitor.
`post_url`	yes	The post to watch.
`reply_message`	yes	The DM sent to each new commenter.
`trigger_keywords`	no	Only DM commenters whose comment includes one of these.
`monitoring_interval`	no	Minutes between checks.

Comment moderation

Beyond replying, you can write, delete and hide / like / pin comments on your own posts.

All three are comment writes — Starter plan and above. Reading comments is open to every active plan.

Create a comment

Platform	New comment	Reply	Notes
Facebook	✅	✅
YouTube	✅	✅	`post_id` is the video id
LinkedIn	✅	✅	`post_id` is the post URN
TikTok	✅	✅	`post_id` (video id) is always required
Instagram	❌	✅	Replies only — `comment_id` required

comment_id → a public reply under that comment. post_id or post_url → a new top-level comment. Platforms: instagram, facebook, youtube, linkedin, tiktok.

curl -X POST https://api.madiad.com/v1/engagement/comments/create \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "facebook", "post_id": "'$POST_ID'", "message": "Thanks for stopping by." }'

Instagram allows replies only — it publishes no way to start a comment thread, so comment_id is required. TikTok always needs post_id (the video id), replies included. Both rules are checked here and answer 400 with the reason, rather than letting the platform refuse.

Delete a comment

Platform	Delete	Notes
Facebook · YouTube · Instagram	✅	`comment_id` alone
LinkedIn	✅	Also needs `post_id` (the post URN)
TikTok	✅	Only comments written by the connected account

curl -X POST https://api.madiad.com/v1/engagement/comments/delete \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "facebook", "comment_id": "'$COMMENT_ID'" }'

LinkedIn additionally needs post_id (the post URN). Deletion is irreversible on the platform.

Hide, like, pin

Platform	Status
TikTok	✅ available
Every other platform	❌ `400` `platform_not_supported`

Every action carries its own inverse — you send a verb, never a boolean, so replaying a request can never flip a comment back to where it started.

`action`	Needs `post_id`?
`hide` · `unhide` · `pin` · `unpin`	Yes
`like` · `unlike`	No

curl -X POST https://api.madiad.com/v1/engagement/comments/action \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "'$PROFILE_ID'", "platform": "tiktok", "comment_id": "'$COMMENT_ID'", "post_id": "'$VIDEO_ID'", "action": "pin" }'

Only TikTok answers this group today. Other platforms return 400 with error_code platform_not_supported naming what is supported — branch on the code, don’t hard-code a list.

Get Started

Concepts

Integrations

API Reference

List recent media

Comments

Direct messages

AutoDM monitors

Comment moderation

Create a comment

Delete a comment

Hide, like, pin

​List recent media

​Comments

​Direct messages

​AutoDM monitors

​Comment moderation

​Create a comment

​Delete a comment

​Hide, like, pin

List recent media

Comments

Direct messages

AutoDM monitors

Comment moderation

Create a comment

Delete a comment

Hide, like, pin