Content parameters

Requested with POST /v1/content-generations. 10 parameters. Content is written from a completed title result or catalog group you own, for 1 to 10 channels.

{"source": {"subject": {"type": "title_result", "id": "<X-Result-ID>"}, "objective": "optional, up to 1,000 characters", "brand_voice": "optional"}, "parameters": ["blog_topics", "content_brief"], "channels": ["blog"]}

Channels: blog, sem, email, product, instagram, facebook, x, pinterest, tiktok, youtube. At most 16 output-channel pairs per request (422 selection_limit); the three topic parameters share one output. A catalog group source may hold at most 50 products.

Every parameter returns an array of items, each with channel, basis (always suggested) and kind. Written content is a starting point to check: briefs and audience-fit items list the facts still missing.

Recorded 2026-10-08 by the Prompt Lab on live data, before the 2026-10-09 release; lists cut to two items ("..." marks the cut) and long text shortened. The content shape did not change in that release.

Parameters

37. ad_topics

Paid-search ad topics.

Returns: array of {channel, basis, kind: "topic", title, angle, keyword_ids}.

Requires the sem channel.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "ad_topics": [
    {"channel": "sem", "basis": "suggested", "kind": "topic", "title": "Plan Your Next Lake or River Outing with the Nordic Kayaks NK K1 Kayak", "angle": "Frame the NK K1 as a kayak for shoppers interested in recreational paddling and exploring waterways. Keep the landing-page angle focused on choosing a kayak for personal outdoor outings; do not claim specific stabilit...", "keyword_ids": ["2097452", "2137192", "..."]}
  ]
}

38. blog_topics

Blog article topics.

Returns: array of {channel, basis, kind: "topic", title, angle, keyword_ids}.

Requires the blog channel.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "blog_topics": [
    {"channel": "blog", "basis": "suggested", "kind": "topic", "title": "Planning a Calm-Water Outing: How to Match a Recreational Kayak to Your Lake or River Route", "angle": "Use the Nordic Kayaks NK K1 Kayak (Model: NK K1) as the concrete shopping example for readers planning recreational paddling or exploring lakes and rivers. Explain how to assess a route's water conditions, distance, l...", "keyword_ids": ["2097452", "8963537", "..."]}
  ]
}

39. video_topics

Short and long video topics.

Returns: array of {channel, basis, kind: "topic", title, angle, keyword_ids}.

Requires the tiktok or youtube channel.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "video_topics": [
    {"channel": "tiktok", "basis": "suggested", "kind": "topic", "title": "Plan a Lake Paddle Around the Nordic Kayaks NK K1 Kayak", "angle": "A quick, outing-first concept: open with the question "What makes a lake day feel like your kind of paddle?" Introduce the Nordic Kayaks NK K1 Kayak by its model and brand, then show a simple decision path--choose a su...", "keyword_ids": ["2097452", "8963537", "..."]},
    {"channel": "youtube", "basis": "suggested", "kind": "topic", "title": "Choosing a Recreational Kayak for Lakes and Rivers: An Outing-First Guide", "angle": "Build a 3-5 minute buyer guide around matching a kayak choice to the outing, using the Nordic Kayaks NK K1 Kayak as the featured product: Model NK K1, a kayak by Nordic Kayaks. Compare how a calm-lake paddle, a river ...", "keyword_ids": ["2097452", "2137192", "..."]}
  ]
}

40. content_prompts

Ready-to-use writing prompts for each channel.

Returns: array of {channel, basis, kind: "prompt", text}.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "content_prompts": [
    {"channel": "blog", "basis": "suggested", "kind": "prompt", "text": "Write a useful 300-450-word SEO blog article centered on the product "Nordic Kayaks NK K1 Kayak."\n\nKnown product facts:\n- Model: NK K1\n- product_type: Kayak\n- brand: Nordic Kayaks\n\nObjective: Help recreational and tou..."}
  ]
}

46. keyword_content_groups

Keywords grouped into content themes.

Returns: array of {channel, basis, kind: "keyword_group", title, keyword_ids}.

The source title result must hold retrieved keywords; otherwise 422 keywords_required.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "keyword_content_groups": [
    {"channel": "blog", "basis": "suggested", "kind": "keyword_group", "title": "Choosing a Kayak for Recreational Paddling on Calm Lakes", "keyword_ids": ["2097452", "8963537", "..."]}
  ]
}

47. buyer_journey_questions

Questions shoppers ask at each buying stage.

Returns: array of {channel, basis, kind: "questions", items: [{stage, question}]}; stage is discovery, evaluation or friction.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "buyer_journey_questions": [
    {"channel": "blog", "basis": "suggested", "kind": "questions", "items": [{"stage": "discovery", "question": "What makes a kayak a practical choice for relaxed lake outings and recreational paddling?"}, {"stage": "evaluation", "question": "How should I compare the NK K1 with other recreational kayaks for the waterways I plan to explore?"}, "..."]}
  ]
}

48. audience_fit

Who the product suits, what they need and what facts are still missing.

Returns: array of {channel, basis, kind: "audience_fit", audience, need, known_product_facts, missing_facts}.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "audience_fit": [
    {"channel": "blog", "basis": "suggested", "kind": "audience_fit", "audience": "Recreational paddlers and outdoor enthusiasts considering the Nordic Kayaks NK K1 Kayak for lake outings or river trips.", "need": "Help shoppers assess whether this kayak suits their planned waterways and paddling needs. Before deciding, they need to compare its intended water conditions, capacity, size and weight with their route, paddler and tr...", "known_product_facts": ["Nordic Kayaks NK K1 Kayak", "Model: NK K1", "..."], "missing_facts": ["Intended water conditions and kayak design details", "Maximum capacity and dimensions", "..."]}
  ]
}

49. content_brief

A content brief: objective, audience, key points and missing facts.

Returns: array of {channel, basis, kind: "brief", objective, audience, key_points, missing_facts}.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "content_brief": [
    {"channel": "blog", "basis": "suggested", "kind": "brief", "objective": "Create a practical buying guide centered on the Nordic Kayaks NK K1 Kayak, helping recreational paddlers decide whether it suits outings on lakes or rivers and what to compare before choosing a kayak. Use the product ...", "audience": "Kayakers and outdoor enthusiasts considering a kayak for recreational paddling or exploring waterways, including shoppers comparing options for lake and river outings.", "key_points": ["Open with the known details: Nordic Kayaks NK K1 Kayak; Model: NK K1; product_type: Kayak; brand: Nordic Kayaks. Frame the guide around matching a kayak to the paddler's plans, not unsupported claims about this model.", "Explain how to compare intended water conditions, launch locations, route length, and a paddler's experience when choosing a recreational kayak. Use "recreational kayak" naturally.", "..."], "missing_facts": ["Kayak dimensions, weight, and load capacity, to help shoppers assess fit, transport, and carrying needs.", "Construction/material, seating and storage features, and any included equipment, to enable a concrete product comparison.", "..."]}
  ]
}

50. content_drafts

Draft copy for each channel.

Returns: array of {channel, basis, kind: "draft", text}.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "content_drafts": [
    {"channel": "blog", "basis": "suggested", "kind": "draft", "text": "The Nordic Kayaks NK K1 Kayak is a Nordic Kayaks model categorized as a kayak. For shoppers considering recreational paddling, lake outings, or exploring waterways, the next step is matching the boat's confirmed speci..."}
  ]
}

51. first_test

One simple test to run first, where to run it and what to measure.

Returns: array of {channel, basis, kind: "first_test", action, placement, observable_result}.

Example (subject: saved title result for Nordic Kayaks NK K1 Kayak):

{
  "first_test": [
    {"channel": "blog", "basis": "suggested", "kind": "first_test", "action": "Compare two opening paragraphs for an article about the Nordic Kayaks NK K1 Kayak: one leading with recreational paddling, the other with exploring lakes and rivers. Keep the headline, remaining article, and call to a...", "placement": "At the top of the blog article, rotate the two introductions between comparable reader sessions while keeping the article layout and placement unchanged.", "observable_result": "Compare the share of readers in each version who reach the first H2. Record the result as a comparison, without assuming either introduction will perform better."}
  ]
}

Plain-text version: /docs/content-parameters.md