API Reference

Engagement

The Engagement API exposes every action Outfame performs on your account. Query activity logs, check daily limit usage, and pause or resume engagement programmatically.

Scope required — engagement:manage

Activity types

Outfame performs four types of organic engagement actions:

Type	Description	Default daily limit
`like`	Likes a post from a targeted user to signal interest.	150
`follow`	Follows a targeted user. Auto-unfollows after 3-7 days if not followed back.	60
`comment`	Leaves an AI-generated, contextual comment on a targeted user's post.	20
`story_view`	Views a targeted user's story. Creates a profile visit notification.	200

Get activity log

GET /v1/engagement/activity

Query parameters

Parameter	Type	Required	Description
`account_id`	`string`	Yes	The account ID.
`type`	`string`	No	Filter by activity type: `like`, `follow`, `comment`, `story_view`.
`date`	`string`	No	ISO 8601 date to filter activities. Default: today.
`limit`	`integer`	No	Number of results (max 200). Default: 50.
`cursor`	`string`	No	Pagination cursor.

Request

curl https://api.outfame.com/v1/engagement/activity?account_id=acc_7Gx2kLm9Qr&type=like&limit=5 \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "data": [
    {
      "id": "act_9xKm3LpQ",
      "type": "like",
      "target_username": "fitness_sarah",
      "target_post_id": "CxYz123AbC",
      "source": "hashtag:fitness",
      "quality_score": 0.92,
      "status": "completed",
      "performed_at": "2026-02-09T14:22:31Z"
    },
    {
      "id": "act_8wJl2KoP",
      "type": "like",
      "target_username": "gym_lifestyle",
      "target_post_id": "DwXy456DeF",
      "source": "competitor:competitor1",
      "quality_score": 0.85,
      "status": "completed",
      "performed_at": "2026-02-09T14:21:15Z"
    },
    {
      "id": "act_7vIk1JnO",
      "type": "like",
      "target_username": "healthy_meals_daily",
      "target_post_id": "EvWx789GhI",
      "source": "location:Los Angeles, CA",
      "quality_score": 0.78,
      "status": "completed",
      "performed_at": "2026-02-09T14:19:48Z"
    }
  ],
  "has_more": true,
  "next_cursor": "cur_xYz789AbC"
}

Activity statuses

Status	Description
`completed`	Action was performed successfully.
`skipped`	User was filtered out by targeting rules or safety checks.
`failed`	Action could not be completed (e.g., post was deleted).
`pending`	Action is queued and will be executed shortly.

Get engagement stats

GET /v1/engagement/stats

Returns today's engagement statistics including actions performed, daily limits remaining, and conversion rates.

Request

curl https://api.outfame.com/v1/engagement/stats?account_id=acc_7Gx2kLm9Qr \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "account_id": "acc_7Gx2kLm9Qr",
  "date": "2026-02-09",
  "status": "active",
  "actions": {
    "likes": { "performed": 87, "limit": 150, "remaining": 63 },
    "follows": { "performed": 34, "limit": 60, "remaining": 26 },
    "comments": { "performed": 12, "limit": 20, "remaining": 8 },
    "story_views": { "performed": 142, "limit": 200, "remaining": 58 }
  },
  "total_actions_today": 275,
  "conversion_rates": {
    "like_to_follow_back": 0.048,
    "follow_to_follow_back": 0.22,
    "comment_to_follow_back": 0.15,
    "story_view_to_follow_back": 0.031
  },
  "avg_quality_score": 0.84,
  "next_action_at": "2026-02-09T14:25:00Z",
  "resets_at": "2026-02-10T00:00:00Z"
}

Pause engagement

POST /v1/engagement/pause

Immediately stops all engagement activity for the specified account. Queued actions are cancelled. The account status changes to paused.

Request

curl -X POST https://api.outfame.com/v1/engagement/pause \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_7Gx2kLm9Qr",
    "reason": "Scheduled maintenance"
  }'

Response

{
  "account_id": "acc_7Gx2kLm9Qr",
  "status": "paused",
  "paused_at": "2026-02-09T14:30:00Z",
  "queued_actions_cancelled": 12
}

Resume engagement

POST /v1/engagement/resume

Resumes engagement activity for a paused account. Growth begins again within 1-2 minutes.

Request

curl -X POST https://api.outfame.com/v1/engagement/resume \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_7Gx2kLm9Qr"
  }'

Response

{
  "account_id": "acc_7Gx2kLm9Qr",
  "status": "active",
  "resumed_at": "2026-02-09T15:00:00Z"
}

Safety controls

Outfame enforces strict safety limits to protect your account from platform violations. These limits cannot be exceeded through the API.

Control	Description
Daily limits	Hard caps on each action type, configurable within platform-safe ranges.
Rate pacing	Actions are spread evenly throughout the day with human-like randomization.
Cool-down periods	Automatic pauses between bursts of activity.
Duplicate detection	Never engages with the same user twice in a 72-hour window.
Quality filtering	Bot accounts, spam accounts, and low-quality profiles are automatically excluded.
Auto-pause	Engagement is automatically paused if unusual platform behavior is detected.

Error codes

Status	Code	Description
`400`	`already_paused`	Account is already paused.
`400`	`already_active`	Account is already active.
`400`	`account_suspended`	Account is suspended and cannot be resumed. Contact support.
`400`	`account_in_setup`	Account is still in setup. Wait for validation to complete.
`404`	`account_not_found`	No account with this ID exists.