YepAPI/skills

Content Research Workflow

Content planning with trend and sentiment data using YepAPI endpoints.

Endpoints Used

Endpoint	Cost	Purpose
POST /v1/seo/trends	$0.02	Google Trends interest over time (up to 5 keywords)
POST /v1/seo/keywords/ideas	$0.03	Keyword suggestions from a seed keyword
POST /v1/seo/keywords	$0.15	Bulk keyword metrics (volume, CPC, difficulty)
POST /v1/seo/ai/chatgpt	$0.05	What ChatGPT says about a query
POST /v1/seo/ai/gemini	$0.05	What Gemini says about a query

Workflow

Step 1: Check Trends

Run POST /v1/seo/trends with topic keywords.

{
  "keywords": ["content marketing", "ai content", "seo strategy"]
}

Returns: interest over time for each keyword — spot seasonal patterns and rising topics.

Step 2: Discover Content Angles

Run POST /v1/seo/keywords/ideas with a seed keyword.

{
  "keyword": "content marketing",
  "location": "us"
}

Returns: keyword suggestions you might not have considered — each is a potential content angle.

Step 3: Evaluate Keywords

Run POST /v1/seo/keywords on discovered keywords.

{
  "keywords": ["content marketing strategy", "content marketing examples", "content marketing roi"],
  "location": "us"
}

Returns: search volume, CPC, keyword difficulty, search intent, 12-month trends.

Step 4: Check AI Visibility

Run POST /v1/seo/ai/chatgpt and POST /v1/seo/ai/gemini to see what AI says about the topic.

{
  "query": "best content marketing strategies"
}

Returns: what each LLM currently says — useful for understanding the AI landscape around your topic.

Step 5: Compile Content Brief

Compile into a content brief:

• Target keyword — highest opportunity (volume vs difficulty)
• Supporting keywords — related terms to include
• Trend direction — rising, stable, or declining
• AI landscape — what LLMs currently say, gaps to fill

Rules

• Trends data shows seasonal patterns — check for upcoming peaks
• AI visibility checks reveal what LLMs currently say about a topic (useful for AI SEO)
• Keyword ideas give you content angles you might not have considered
• Always check difficulty before committing to a keyword — avoid DR 80+ terms for new sites

Error Handling

• NO_CREDITS (402) — Tell the user to add credits at https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Retry once; if it fails again, skip that step and note it
• VALIDATION_ERROR (400) — Check keyword format; keywords must be non-empty strings
• RATE_LIMITED (429) — Wait and retry; respect the Retry-After header