Publication Discovery

Discover current content opportunities

Returns tailored idea cards with selectable angles and platform treatments. It never drafts or publishes a post.

post/publication-opportunities/discover

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/publication-opportunities/discover
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

audiencestring

People the opportunities should matter to

focusstring

Optional subject, project, niche, or current objective

limitinteger

Maximum opportunity cards to return

platformsstring[] nullable required

Selected native destination platforms

voice_profile_idstring

Optional Workspace Voice Profile; defaults to the Workspace identity

workspace_idstring required

Workspace whose editor is requesting opportunities

Example request

{
  "$schema": "https://example.com/api/v1/schemas/DiscoverPublicationOpportunitiesInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

generated_atstring date-time required
modelstring required

Example response

{
  "$schema": "https://example.com/api/v1/schemas/DiscoveryResult.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.