OpenPost Growth API
The Growth API from OpenPost — 4 operation(s) for growth.
The Growth API from OpenPost — 4 operation(s) for growth.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/openpo-st:openpo-st-growth-api"
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.
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: 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