# Get Comment Automations

### Get Comment Automations

Retrieve a paginated list of all comment automation bots associated with your account.

This endpoint allows you to list, browse, and manage all your comment automation configurations, including their trigger rules, response settings, channels, and AI configurations.

***

### Method

`GET`

### URL

```
https://app.marketingblocks.ai/api/v1/social-sparks/get-comment-automations
```

***

### Permission

`read-comment-automations`

***

### Headers

```
Authorization: Bearer <token>
Content-Type: application/json
```

***

### Query Parameters

| Parameter | Type    | Required | Default | Description                          |
| --------- | ------- | -------- | ------- | ------------------------------------ |
| limit     | integer | No       | `10`    | Number of records to return per page |
| page      | integer | No       | `1`     | Page number for pagination           |
| sort\_by  | string  | No       | `desc`  | Sort order. Options: `asc`, `desc`   |

***

### Example Request

```bash
curl --location 'https://app.marketingblocks.ai/api/v1/social-sparks/get-comment-automations?limit=10&sort_by=desc&page=1' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
```

***

### Example Response

```json
{
  "comment_bots": {
    "current_page": 1,
    "data": [
      {
        "id": 162,
        "name": "Update Comment Automation",
        "trigger_type": "any",
        "triggers": null,
        "response_type": "both",
        "reply_frequency": "everytime",
        "response_time": "instant",
        "delay_time": "0",
        "status": "active",
        "channels": [4125, 4500],
        "next_call_time_stamp": "1777561563",
        "created_at": "April 30, 2026 1:52 PM",
        "updated_at": "April 30, 2026 3:05 PM",
        "response": {
          "comment_responses": ["Thanks for the comment"],
          "dm_responses": "Thank you a comment on my post"
        },
        "ai_enable": "yes",
        "ai_settings": {
          "response_tone": "friendly",
          "response_length": "very short",
          "ai_personality": "assistant",
          "creativity_level": "conservative",
          "language_style": "conversational",
          "emoji_usage": "none"
        }
      }
    ],
    "current_page": 1,
    "per_page": 10,
    "total": 6,
    "last_page": 1,
    "from": 1,
    "to": 6,
    "first_page_url": "...",
    "last_page_url": "...",
    "next_page_url": null,
    "prev_page_url": null,
    "path": "https://app.marketingblocks.ai/api/v1/social-sparks/get-comment-automations"
  },
  "status": true
}
```

*(Response truncated for brevity — full structure available in API output)*

***

### Response Fields

| Field         | Type    | Description                                  |
| ------------- | ------- | -------------------------------------------- |
| comment\_bots | object  | Paginated list of comment automation bots    |
| status        | boolean | Indicates whether the request was successful |

***

### Pagination Object

| Field            | Type        | Description              |
| ---------------- | ----------- | ------------------------ |
| current\_page    | integer     | Current page number      |
| per\_page        | integer     | Number of items per page |
| total            | integer     | Total number of records  |
| last\_page       | integer     | Total number of pages    |
| from             | integer     | Starting record index    |
| to               | integer     | Ending record index      |
| first\_page\_url | string      | URL for first page       |
| last\_page\_url  | string      | URL for last page        |
| next\_page\_url  | string/null | URL for next page        |
| prev\_page\_url  | string/null | URL for previous page    |

***

### Comment Bot Object

| Field                   | Type            | Description                                            |
| ----------------------- | --------------- | ------------------------------------------------------ |
| id                      | integer         | Unique ID of the comment automation                    |
| name                    | string          | Name of the automation                                 |
| trigger\_type           | string          | Trigger logic (`any`, `keywords`)                      |
| triggers                | array/null      | Keywords or trigger conditions                         |
| response\_type          | string          | Response type (`comment`, `direct_message`, `both`)    |
| reply\_frequency        | string          | Frequency of replies (`everytime`, `once`, `randomly`) |
| response\_time          | string          | Response timing (`instant`, `delayed`)                 |
| delay\_time             | string/integer  | Delay before responding                                |
| status                  | string          | Automation status (`active`, `stopped`)                |
| channels                | array\[integer] | Associated channel IDs                                 |
| next\_call\_time\_stamp | string          | Next execution timestamp                               |
| created\_at             | string          | Creation timestamp                                     |
| updated\_at             | string          | Last updated timestamp                                 |
| response                | object          | Response configuration                                 |
| ai\_enable              | string          | Whether AI is enabled (`yes`, `no`)                    |
| ai\_settings            | object/null     | AI configuration (if enabled)                          |

***

### Response Object

| Field              | Type           | Description            |
| ------------------ | -------------- | ---------------------- |
| comment\_responses | array\[string] | Public comment replies |
| dm\_responses      | string         | Direct message reply   |

***

### Notes

* This endpoint returns a **paginated list** of comment automations
* Use `limit` and `page` to control pagination
* Use `sort_by` to control ordering (`asc` or `desc`)
* The request token must include the `read-comment-automations` permission
* If the token is missing, expired, or invalid, the API returns `401 Unauthorized`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.marketingblocks.ai/agentic-ai-docs/api-reference/social-growth-engine/comment-automation/get-comment-automations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.