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

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

audience?string

People the opportunities should matter to

Lengthlength <= 500

focus?string

Optional subject, project, niche, or current objective

Lengthlength <= 1000

limit?integer

Maximum opportunity cards to return

Formatint64

Range1 <= value <= 8

Default6

platforms*array<string>|

Selected native destination platforms

Items1 <= items <= 5

recent_publications?array<>|

Recent Publications used only to avoid repetition

Itemsitems <= 30

voice_profile_id?string

Optional Workspace Voice Profile; defaults to the Workspace identity

workspace_id*string

Workspace whose editor is requesting opportunities

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/publication-opportunities/discover" \  -H "Content-Type: application/json" \  -d '{    "platforms": [      "string"    ],    "workspace_id": "string"  }'

{  "$schema": "https://example.com/api/v1/schemas/DiscoveryResult.json",  "generated_at": "2019-08-24T14:15:22Z",  "model": "string",  "opportunities": [    {      "angles": [        {          "approach": "string",          "id": "string",          "label": "string",          "thesis": "string"        }      ],      "hook": "string",      "id": "string",      "platform_treatments": [        {          "format": "string",          "media": "string",          "objective": "string",          "platform": "string",          "rationale": "string"        }      ],      "signal_date": "string",      "title": "string",      "why_it_fits": "string",      "why_now": "string"    }  ]}

Discover current content opportunities

Authorization

Request Body

Response Body

200application/json

400application/problem+json

401application/problem+json

403application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

502application/problem+json

503application/problem+json

504application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`