---
title: "List growth recommendations"
method: GET
path: "/growth"
tags: ["Growth"]
---

# List growth recommendations

`GET /growth`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/growth`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

Returns DB-only growth recommendations for one connected social account. Growth recommendations belong to one social_account_id, not merely a workspace.

## Query parameters

- `workspace_id` string, required: Workspace ID
- `account_id` string, required: Connected social account ID

## Response `200`

OK

- ListResult
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `follow_updates` FollowUpdateView[], nullable, required
    - `follow_error_code` string
    - `follow_error_message` string
    - `follow_state` 'following' | 'requested', required
    - `generation_id` string, required
    - `id` string, required
    - `updated_at` string, date-time, required
  - `items` RecommendationView[], nullable, required
    - `avatar_url` string, required
    - `bio` string, required
    - `created_at` string, date-time, required
    - `display_name` string, required
    - `follow_error_code` string
    - `follow_error_message` string
    - `follow_state` 'idle' | 'pending' | 'following' | 'requested' | 'failed', required
    - `followers_count` integer, required
    - `following_count` integer, required
    - `follows_viewer` boolean, required
    - `generation_id` string, required
    - `handle` string, required
    - `id` string, required
    - `last_seen_at` string, date-time, required
    - `mutual_count` integer, required
    - `mutual_exact` boolean, required
    - `mutuals` GrowthMutualProfile[], nullable, required
      - `AvatarURL` string, required
      - `DisplayName` string, required
      - `Handle` string, required
      - `RemoteID` string, required
    - `platform` string, required
    - `profile_url` string, required
    - `remote_account_id` string, required
    - `score` number, double, required
    - `signals` string[], nullable, required
    - `social_account_id` string, required
    - `updated_at` string, date-time, required
    - `workspace_id` string, required
  - `sync_state` SyncStateView, required
    - `created_at` string, date-time, required
    - `current_generation_id` string, required
    - `error_code` string
    - `error_message` string
    - `id` string, required
    - `last_attempted_at` string, date-time
    - `last_success_at` string, date-time
    - `platform` string, required
    - `social_account_id` string, required
    - `status` 'idle' | 'queued' | 'refreshing' | 'ok' | 'permission_required' | 'rate_limited' | 'temporarily_unavailable' | 'failed', required
    - `updated_at` string, date-time, required
    - `workspace_id` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)