OpenPost Publication Discovery API
The Publication Discovery API from OpenPost — 1 operation(s) for publication discovery.
The Publication Discovery API from OpenPost — 1 operation(s) for publication discovery.
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-publication-discovery-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 Publication Discovery 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: Publication Discovery
paths:
/publication-opportunities/discover:
post:
description: Returns tailored idea cards with selectable angles and platform treatments. It never drafts or publishes a post.
operationId: discover-publication-opportunities
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DiscoverPublicationOpportunitiesInputBody'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DiscoveryResult'
description: OK
'400':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Request
'401':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unauthorized
'403':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Forbidden
'422':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Unprocessable Entity
'429':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Too Many Requests
'500':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Internal Server Error
'502':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Bad Gateway
'503':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Service Unavailable
'504':
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ErrorModel'
description: Gateway Timeout
summary: Discover current content opportunities
tags:
- Publication Discovery
components:
schemas:
DiscoverPublicationOpportunitiesInputBody:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/DiscoverPublicationOpportunitiesInputBody.json
format: uri
readOnly: true
type: string
audience:
description: People the opportunities should matter to
maxLength: 500
type: string
focus:
description: Optional subject, project, niche, or current objective
maxLength: 1000
type: string
limit:
default: 6
description: Maximum opportunity cards to return
format: int64
maximum: 8
minimum: 1
type: integer
platforms:
description: Selected native destination platforms
items:
type: string
maxItems: 32
minItems: 1
type:
- array
- 'null'
uniqueItems: true
recent_publications:
description: Recent Publications used only to avoid repetition
items:
$ref: '#/components/schemas/RecentPublicationSummary'
maxItems: 30
type:
- array
- 'null'
voice_profile_id:
description: Optional Workspace Voice Profile; defaults to the Workspace identity
type: string
workspace_id:
description: Workspace whose editor is requesting opportunities
type: string
required:
- workspace_id
- platforms
type: object
DiscoveryResult:
additionalProperties: false
properties:
$schema:
description: A URL to the JSON Schema for this object.
examples:
- https://example.com/api/v1/schemas/DiscoveryResult.json
format: uri
readOnly: true
type: string
generated_at:
format: date-time
type: string
model:
type: string
opportunities:
items:
$ref: '#/components/schemas/Opportunity'
type:
- array
- 'null'
required:
- generated_at
- model
- opportunities
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
RecentPublicationSummary:
additionalProperties: false
properties:
platforms:
description: Platforms that received the Publication
items:
type: string
maxItems: 32
type:
- array
- 'null'
uniqueItems: true
published_at:
description: When this recent Publication was published or created
format: date-time
type: string
summary:
description: Short factual summary of what the Publication said
maxLength: 800
type: string
topics:
description: Topics already covered
items:
type: string
maxItems: 12
type:
- array
- 'null'
uniqueItems: true
required:
- published_at
- summary
type: object
Opportunity:
additionalProperties: false
properties:
angles:
items:
$ref: '#/components/schemas/Angle'
type:
- array
- 'null'
hook:
type: string
id:
type: string
platform_treatments:
items:
$ref: '#/components/schemas/PlatformTreatment'
type:
- array
- 'null'
signal_date:
type: string
title:
type: string
why_it_fits:
type: string
why_now:
type: string
required:
- id
- title
- why_it_fits
- why_now
- signal_date
- hook
- angles
- platform_treatments
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
PlatformTreatment:
additionalProperties: false
properties:
format:
type: string
media:
type: string
objective:
type: string
platform:
type: string
rationale:
type: string
required:
- platform
- objective
- format
- rationale
- media
type: object
Angle:
additionalProperties: false
properties:
approach:
type: string
id:
type: string
label:
type: string
thesis:
type: string
required:
- id
- label
- thesis
- approach
type: object
securitySchemes:
bearerAuth:
bearerFormat: OpenPost API token or session JWT
scheme: bearer
type: http
sessionCookie:
in: cookie
name: openpost_session
type: apiKey