---
title: "Get an activity with a 14-day trend"
method: GET
path: "/activities/{id}"
tags: ["Activities"]
---

# Get an activity with a 14-day trend

`GET /activities/{id}`

## Request

- Base URL: `https://social-automation.cresclab.com/api/v1`
- URL: `https://social-automation.cresclab.com/api/v1/activities/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cresclab/apis/social-automation-api/docs/activities/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- object
  - `activity` Activity
    - `id` string
    - `name` string
    - `status` 'draft' | 'active' | 'paused'
    - `account_id` string
    - `platform` 'instagram' | 'facebook' | 'threads'
    - `trigger` 'ig_comment' | 'ig_story' | 'ig_live' | 'ig_message' | 'fb_comment' | 'fb_live' | 'fb_message' | 'threads_reply': `ig_comment` (instagram): A comment on an Instagram post or Reel. `ig_story` (instagram): A reply to (or mention in) an Instagram Story. post_ids, if set, are story ids. `ig_live` (instagram): A comment during an Instagram Live broadcast (only while the broadcast is live). `ig_message` (instagram): An Instagram DM sent to the account. dm_source "keywords" (default) answers DMs that match a keyword; dm_source "ads" answers only the first DM of a conversation opened from an ad (live video ads, click-to-Instagram-Direct ads), keywords optional. `fb_comment` (facebook): A comment on a Facebook Page post. The DM is sent through Messenger. `fb_live` (facebook): A comment during a Facebook Live broadcast (only while the broadcast is live). `fb_message` (facebook): A Messenger message sent to the Page; the activity replies in Messenger. dm_source "ads" answers only conversations opened from an ad (live video ads, click-to-Messenger ads). `threads_reply` (threads): A reply to a Threads post. Public reply only: Meta offers no Threads DM API. Meta allows up to 1,000 replies per Threads profile per 24 hours.
    - `keywords` string[]
    - `match` 'contains' | 'exact'
    - `public_replies` string[]
    - `dm` DmBlock[]
      - `type` 'text' | 'button' | 'image' | 'card', required
      - `text` string: type=text: message text (all text together ≤1000 chars, ≤640 when buttons are present).
      - `title` string: type=button: button label ≤20 chars. type=card: card title ≤80 chars.
      - `url` string: type=button: link opened by the button (full https URL).
      - `image_url` string: type=image or card: publicly reachable direct image URL (PNG/JPEG). Share-page links (Google Drive, Dropbox pages) are rejected.
      - `subtitle` string: type=card: optional subtitle ≤80 chars.
      - `buttons` object[]: type=card: up to 3 link buttons on the card.
        - `title` string, required
        - `url` string, required
    - `post_scope` 'all' | 'selected' | 'next_post'
    - `post_ids` string[], nullable
    - `follow_gate` object: Instagram only (ig_comment, ig_live): ask the commenter to follow the account before the DM content is delivered.
      - `enabled` boolean, required
      - `opening_text` string: First DM with a button, sent before checking the follow.
      - `button_title` string: Label of that button, ≤20 chars.
      - `not_following_text` string: Sent when the person does not follow yet.
    - `start_at` string, nullable
    - `end_at` string, nullable
    - `created_at` string
    - `updated_at` string
    - `dashboard_url` string
    - `stats` object
      - `public_replies_sent` integer
      - `dms_sent` integer
  - `daily` object[]
    - `date` string
    - `successful_triggers` integer

## Other responses

- `400`: Invalid request (see error.field)
- `401`: Missing or invalid API key
- `403`: Insufficient scope, trial expired, contract expired or plan limit (see error.code and error.action_url)
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/cresclab/apis/social-automation-api.md) - [All operations](https://skmtc.dev/cresclab/apis/social-automation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cresclab/apis/social-automation-api/revisions/1d4ea62ba46d?raw)