OpenPost Growth API

The Growth API from OpenPost — 4 operation(s) for growth.

GitHub OpenAPI

Operations 4

GET /growth List growth recommendations #
POST /growth/refresh Queue growth discovery refresh #
POST /growth/{recommendation_id}/dismiss Dismiss a growth recommendation #
POST /growth/{recommendation_id}/follow Follow a recommended account #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-growth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openpo-st-growth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: hello@openpo.st
    name: OpenPost support
    url: https://openpo.st/contact
  description: OpenPost HTTP API for workspace-scoped social publishing. Use it to inspect accounts and provider readiness, manage media and publications, schedule work, and read publishing results. Every operation still follows token scopes, workspace roles, plan limits, provider capabilities, and destination validation.
  license:
    identifier: AGPL-3.0-only
    name: AGPL-3.0-only
  termsOfService: https://openpo.st/terms
  title: OpenPost Growth API
  version: 1.0.0
servers:
- description: OpenPost Hosted service
  url: https://app.openpo.st/api/v1
- description: The OpenPost instance serving this contract
  url: /api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:
- name: Growth
paths:
  /growth:
    get:
      description: Returns DB-only growth recommendations for one connected social account. Growth recommendations belong to one social_account_id, not merely a workspace.
      operationId: list-growth-recommendations
      parameters:
      - description: Workspace ID
        explode: false
        in: query
        name: workspace_id
        required: true
        schema:
          description: Workspace ID
          type: string
      - description: Connected social account ID
        explode: false
        in: query
        name: account_id
        required: true
        schema:
          description: Connected social account ID
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResult'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: List growth recommendations
      tags:
      - Growth
      x-openpost-automation:
        access: read
        effect: query
        exposure: alpha
        idempotency: none
        retry: transient
        selectors:
        - label_path: name
          operation_id: list-workspaces
          parameter: workspace_id
          value_path: id
        - label_path: account_username
          operation_id: list-accounts
          parameter: account_id
          value_path: id
  /growth/refresh:
    post:
      description: Queues a durable discovery job for one social account. Uses provider reads with retry/requeue. Does not block on provider.
      operationId: refresh-growth-recommendations
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefreshGrowthInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshGrowthOutputBody'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Queue growth discovery refresh
      tags:
      - Growth
  /growth/{recommendation_id}/dismiss:
    post:
      description: Locally dismisses a recommendation. Dismissed items never reappear after refresh.
      operationId: dismiss-growth-recommendation
      parameters:
      - description: Growth recommendation ID
        in: path
        name: recommendation_id
        required: true
        schema:
          description: Growth recommendation ID
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DismissGrowthInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DismissGrowthOutputBody'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Dismiss a growth recommendation
      tags:
      - Growth
  /growth/{recommendation_id}/follow:
    post:
      description: Queues a one-attempt provider write through the durable providerwrite fence. Never retries ambiguous writes.
      operationId: follow-growth-recommendation
      parameters:
      - description: Growth recommendation ID
        in: path
        name: recommendation_id
        required: true
        schema:
          description: Growth recommendation ID
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FollowGrowthInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FollowGrowthOutputBody'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
      summary: Follow a recommended account
      tags:
      - Growth
components:
  schemas:
    SyncStateView:
      additionalProperties: false
      properties:
        created_at:
          format: date-time
          type: string
        current_generation_id:
          type: string
        error_code:
          type: string
        error_message:
          type: string
        id:
          type: string
        last_attempted_at:
          format: date-time
          type: string
        last_success_at:
          format: date-time
          type: string
        platform:
          type: string
        social_account_id:
          type: string
        status:
          enum:
          - idle
          - queued
          - refreshing
          - ok
          - permission_required
          - rate_limited
          - temporarily_unavailable
          - failed
          type: string
        updated_at:
          format: date-time
          type: string
        workspace_id:
          type: string
      required:
      - id
      - workspace_id
      - social_account_id
      - platform
      - status
      - current_generation_id
      - created_at
      - updated_at
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    RefreshGrowthInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/RefreshGrowthInputBody.json
          format: uri
          readOnly: true
          type: string
        account_id:
          description: Connected social account ID
          type: string
        workspace_id:
          description: Workspace ID
          type: string
      required:
      - workspace_id
      - account_id
      type: object
    ListResult:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ListResult.json
          format: uri
          readOnly: true
          type: string
        follow_updates:
          items:
            $ref: '#/components/schemas/FollowUpdateView'
          type:
          - array
          - 'null'
        items:
          items:
            $ref: '#/components/schemas/RecommendationView'
          type:
          - array
          - 'null'
        sync_state:
          $ref: '#/components/schemas/SyncStateView'
      required:
      - items
      - sync_state
      - follow_updates
      type: object
    DismissGrowthInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/DismissGrowthInputBody.json
          format: uri
          readOnly: true
          type: string
        workspace_id:
          description: Workspace ID
          type: string
      required:
      - workspace_id
      type: object
    FollowGrowthOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/FollowGrowthOutputBody.json
          format: uri
          readOnly: true
          type: string
        job_id:
          description: Queued job ID
          type: string
        message:
          description: Human readable message
          type: string
        status:
          description: Pending follow status
          type: string
      required:
      - job_id
      - status
      - message
      type: object
    RefreshGrowthOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/RefreshGrowthOutputBody.json
          format: uri
          readOnly: true
          type: string
        job_id:
          description: Queued job ID
          type: string
        message:
          description: Human readable message
          type: string
        status:
          description: Queued status
          type: string
      required:
      - job_id
      - status
      - message
      type: object
    DismissGrowthOutputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/DismissGrowthOutputBody.json
          format: uri
          readOnly: true
          type: string
        status:
          description: Dismiss status
          type: string
      required:
      - status
      type: object
    GrowthMutualProfile:
      additionalProperties: false
      properties:
        AvatarURL:
          type: string
        DisplayName:
          type: string
        Handle:
          type: string
        RemoteID:
          type: string
      required:
      - RemoteID
      - Handle
      - DisplayName
      - AvatarURL
      type: object
    FollowGrowthInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/FollowGrowthInputBody.json
          format: uri
          readOnly: true
          type: string
        workspace_id:
          description: Workspace ID
          type: string
      required:
      - workspace_id
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    FollowUpdateView:
      additionalProperties: false
      properties:
        follow_error_code:
          type: string
        follow_error_message:
          type: string
        follow_state:
          enum:
          - following
          - requested
          type: string
        generation_id:
          type: string
        id:
          type: string
        updated_at:
          format: date-time
          type: string
      required:
      - id
      - follow_state
      - updated_at
      - generation_id
      type: object
    RecommendationView:
      additionalProperties: false
      properties:
        avatar_url:
          type: string
        bio:
          type: string
        created_at:
          format: date-time
          type: string
        display_name:
          type: string
        follow_error_code:
          type: string
        follow_error_message:
          type: string
        follow_state:
          enum:
          - idle
          - pending
          - following
          - requested
          - failed
          type: string
        followers_count:
          format: int64
          type: integer
        following_count:
          format: int64
          type: integer
        follows_viewer:
          type: boolean
        generation_id:
          type: string
        handle:
          type: string
        id:
          type: string
        last_seen_at:
          format: date-time
          type: string
        mutual_count:
          format: int64
          type: integer
        mutual_exact:
          type: boolean
        mutuals:
          items:
            $ref: '#/components/schemas/GrowthMutualProfile'
          type:
          - array
          - 'null'
        platform:
          type: string
        profile_url:
          type: string
        remote_account_id:
          type: string
        score:
          format: double
          type: number
        signals:
          items:
            type: string
          type:
          - array
          - 'null'
        social_account_id:
          type: string
        updated_at:
          format: date-time
          type: string
        workspace_id:
          type: string
      required:
      - id
      - workspace_id
      - social_account_id
      - platform
      - remote_account_id
      - handle
      - display_name
      - bio
      - avatar_url
      - profile_url
      - followers_count
      - following_count
      - mutual_count
      - mutuals
      - mutual_exact
      - follows_viewer
      - signals
      - score
      - generation_id
      - follow_state
      - last_seen_at
      - created_at
      - updated_at
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey