New in Content Harmony this week: we've expanded our API to cover endpoints for every section of our Content Workflows, from Keyword Report to Content Brief and Content Grader.
What's New
We opened up on API in Beta earlier this year that allow you to fetch team details, retrieve/create/update your Projects, and create/retrieve basic Content Workflow details.
In November, we significantly expanded our API with full read-level access to every section of your Content Workflow.
The API now includes 20+ dedicated endpoints that give you programmatic access to every component of your content research workflow.
Content Workflows API Updates
All endpoints are now organized under /api/v2/content_workflows/:id/ with dedicated resources for each tab or section of the workflow.
Core Workflow Data:
A sample response for a Content Workflow:
{
"object": "keyword_brief",
"id": 1,
"keywords": "tatooine",
"country_code": "US",
"lang_code": "en",
"project_id": 1,
"status": "completed",
"created_at": "2024-12-02T23:39:21.288Z",
"started_at": null,
"completed_at": "2025-12-01T23:39:21.288Z",
"content_difficulty": null,
"average_word_count": null,
"search_volume": null,
"cpc": null,
"links": [
{
"object": "link",
"id": null,
"show_discussion": true,
"url": "https://app.contentharmony.com/l/abcd12303/brief"
},
{
"object": "link",
"id": null,
"show_discussion": false,
"url": "https://app.contentharmony.com/l/abcd12304/brief"
}
],
"resources": {
"intent": "https://app.contentharmony.com/api/v2/content_workflows/1/intent",
"topics": "https://app.contentharmony.com/api/v2/content_workflows/1/topics",
"related_keywords": "https://app.contentharmony.com/api/v2/content_workflows/1/related_keywords",
"outline": "https://app.contentharmony.com/api/v2/content_workflows/1/outline",
"questions": "https://app.contentharmony.com/api/v2/content_workflows/1/questions",
"referenced_links": "https://app.contentharmony.com/api/v2/content_workflows/1/referenced_links",
"internal_links": "https://app.contentharmony.com/api/v2/content_workflows/1/internal_links",
"gov_edu_sources": "https://app.contentharmony.com/api/v2/content_workflows/1/gov_edu_sources",
"news_sources": "https://app.contentharmony.com/api/v2/content_workflows/1/news_sources",
"suggested_images": "https://app.contentharmony.com/api/v2/content_workflows/1/suggested_images",
"google_image_results": "https://app.contentharmony.com/api/v2/content_workflows/1/google_image_results",
"competitor_images": "https://app.contentharmony.com/api/v2/content_workflows/1/competitor_images",
"shopping_images": "https://app.contentharmony.com/api/v2/content_workflows/1/shopping_images",
"videos": "https://app.contentharmony.com/api/v2/content_workflows/1/videos",
"competitors": "https://app.contentharmony.com/api/v2/content_workflows/1/competitors"
}
}Research & Analysis:
- Intent Analysis - Search intent classification, freshness, and more
- Topics - Our full topic model with priority scoring and competitor usage
- Related Keywords - Semantic keyword variations and search volume data
- Outline - AI-generated & competitor content outlines with heading hierarchy
- Competitors - Top-ranking competitor analysis with metrics
- Questions - Questions from AI Suggestions, PAAs, Quora, and Reddit
- Referenced Links - Curated external sources to reference
- Internal Links - Suggested internal linking opportunities
- Gov/Edu Sources - Authority sources from .gov and .edu domains
- News Sources - Recent news articles related to your topic
- Suggested Images - AI suggested images for your content
- Image Results - Search-based image recommendations
- Competitor Images - Images used by top-ranking competitors
- Shopping Images - Product images from eCommerce results
- Videos - Related video content and YouTube results
Sample response from our Questions tab:
{
"object": "list",
"metadata": {
"total_count": 3,
"highlighted_count": 1,
"by_category": {
"ai_suggestions": 1,
"google_paa": 2,
"quora": 0,
"stack_exchange": 0,
"reddit": 0,
"yahoo_answers": 0
},
"links": [
{
"object": "link",
"id": null,
"show_discussion": true,
"url": "https://app.contentharmony.com/l/abcd123013/questions"
},
{
"object": "link",
"id": null,
"show_discussion": false,
"url": "https://app.contentharmony.com/l/abcd123014/questions"
}
]
},
"questions": [
{
"object": "question",
"id": 1,
"question_text": "Where is Tatooine in real life?",
"category": "ai_suggestion",
"category_name": "AI Suggestion",
"source_position": 0,
"snippet": null,
"title": null,
"displayed_link": null,
"highlighted": true
},
{
"object": "question",
"id": 2,
"question_text": "Why is Tatooine included in so many Star Wars plots?",
"category": "desktop",
"category_name": "Google PAA",
"source_position": 0,
"snippet": "Tatooine filming locations include Tunisia in North Africa...",
"title": "Tatooine Filming Locations",
"displayed_link": "en.wikipedia.org/wiki/Tatooine",
"url": "https://en.wikipedia.org/wiki/Tatooine",
"highlighted": false
},
{
"object": "question",
"id": 3,
"question_text": "What's so special about Tatooine?",
"category": "desktop",
"category_name": "Google PAA",
"source_position": 1,
"snippet": "It appeared twice in the original trilogy because it was Luke's home planet...",
"title": "Understanding Tatooine's Importance",
"displayed_link": "starwars.fandom.com/wiki/Tatooine",
"url": "https://en.wikipedia.org/wiki/Tatooine",
"highlighted": false
}
]
}In addition to the research data from the Keyword Report, you can also access HTML copies of both the Content Brief and the Content Grader:
Content Tools:
- Brief Content - Export editable brief HTML for Google Docs, Word, or other editors
- Content Grader - Score your draft content with readability metrics, word count analysis, and topic coverage
Sample response from our Content Grader:
{
"object": "content_grader",
"keyword_brief_id": 1,
"id": 1,
"created_at": "2025-11-25T23:39:22.077Z",
"updated_at": "2025-12-02T22:39:22.077Z",
"metadata": {
"links": [
{
"object": "link",
"id": 1,
"show_discussion": true,
"url": "https://app.contentharmony.com/l/abc123def456/grader"
},
{
"object": "link",
"id": 2,
"show_discussion": false,
"url": "https://app.contentharmony.com/l/xyz789ghi012/grader"
}
]
},
"content_scoring": {
"content_score": 78,
"content_score_label": "Great",
"content_score_label_color": "grader-great",
"current_word_count": 487,
"recommended_word_count": 650,
"current_readability": 68,
"current_readability_label": "8th Grade",
"recommended_readability": 70,
"recommended_terms_used": 7,
"recommended_terms_total": 10
},
"content_draft": {
"title": "Complete Guide to Living on Tatooine",
"html_content": "<h1>Complete Guide to Living on Tatooine</h1><p>Tatooine, the desert planet orbiting twin suns, presents unique challenges for settlers and moisture farmers. This comprehensive guide covers everything you need to know about surviving and thriving in this harsh environment.</p><h2>Essential Moisture Farming Equipment</h2><p>Moisture farming on Tatooine requires specialized vaporators that extract water from the atmosphere. Quality moisture farming equipment can mean the difference between prosperity and failure in the desert.</p><h2>Key Survival Tips</h2><ul><li>Maintain your vaporator maintenance schedule</li><li>Avoid traveling during the hottest hours</li><li>Watch for Tusken Raider activity</li><li>Keep sandcrawler parts in stock for repairs</li></ul><p>By following these guidelines, you can successfully establish your homestead on Tatooine.</p>",
"url": "https://example.com/tatooine-settlers-guide",
"has_content": true
},
"topics": {
"metadata": {
"total_count": 3,
"highlighted_count": 1
},
"items": [
{
"object": "topic",
"id": 1,
"phrase": "moisture farming equipment",
"documents_count": 8,
"total_occurrences_count": 42,
"priority": 85,
"variants": [
"moisture vaporators",
"water collection equipment"
],
"highlighted": true,
"ignored": false,
"content_grader_uses": 3
},
... (topics continued)API Documentation Improvements
We've completely redesigned our API documentation with:
- Individual pages for each resource type with detailed field descriptions
- Live example responses using realistic data
- Clear endpoint paths and authentication examples
- Inline code samples for cURL, Javascript, Python, and Ruby, along with usage notes
Visit the updated docs portal at https://app.contentharmony.com/api to explore all available endpoints.
How your team can use Content Harmony's API
This update provides the foundation for teams to build sophisticated content operations workflows on top of Content Harmony's data.
- Export workflow data to your content management system with tools like Zapier, Make.com, and n8n
- Build custom dashboards with your content research metrics
- Automate content creation workflows with programmatic access
- Integrate with your tools like Airtable, Notion, or custom applications
- Pull content briefs directly into Google Docs or Microsoft Word
Each endpoint returns JSON data that's ready to use in your applications, with comprehensive field documentation to help you build robust integrations.
✉️ Get an email when we publish new content:
Don't worry, we won't bug you with junk. Just great content marketing resources.
Ready To Try
Content Harmony?
Get your first 10 briefs for just $10
No trial limits or auto renewals. Just upgrade when you're ready.
