API reference

GET/v1/comments

List comments

Lists comments on the profile’s published content. Facebook and Instagram only.

Required permission: `comments:read`

Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.

Base URL
https://api.cutedyno.com
Permission
comments:read
Idempotency
Not applicable. This request has no side effects worth deduplicating.
MCP tool
list_comments

Request

curl -X GET "https://api.cutedyno.com/v1/comments?profileId=PROFILE_ID" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY"

Query parameters

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

platformenumoptional

One of:facebookinstagram

accountIdstringoptional

Restrict to one account. Either `id` or `platformAccountId` from GET /v1/accounts.

limitintegeroptional
cursorstringoptional

Cursor from a previous response.

Response

Returns 200 with the following body.

Comment[]required
nextCursorstringnullablerequired

Example

{
  "comments": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000000",
      "platform": "string",
      "message": "Shipping today.",
      "authorId": "author_a1b2c3d4",
      "authorName": "Acme Corp",
      "authorUsername": "Acme Corp",
      "isHidden": false,
      "hasResponse": false,
      "responseText": "string",
      "postId": "post_a1b2c3d4",
      "parentId": "parent_a1b2c3d4",
      "account": {
        "accountId": "account_a1b2c3d4",
        "name": "Acme Corp",
        "platform": "string",
        "profilePictureUrl": "https://cdn.example.com/media/launch.jpg"
      },
      "createdAt": "string",
      "postedAt": "string"
    }
  ],
  "nextCursor": "string"
}

Errors

Failures use the standard error envelope. Branch on code, never on the message.

StatusCodeWhen it happens
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
403profile_not_accessibleThe requested profile is outside this key’s scope, or belongs to another account.
429rate_limit_exceededToo many requests for this key. Honour the Retry-After header before retrying.
500internal_errorSomething failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.