SEO Research

platform_get_brand_voice

Retrieve your organization’s brand voice profile — company overview, tone, audience, and competitive context. Use this to understand the brand before generating content.

Parameters

None.

Response

{
  "companyName": "ClickFlow",
  "overview": "ClickFlow is an AI-powered SEO platform...",
  "products": "AI content optimization, visibility tracking, workflow automation",
  "audience": "SEO professionals and content teams",
  "industry": "SaaS / Marketing Technology",
  "toneOptions": ["Professional", "Approachable"],
  "styleOptions": ["Data-driven", "Actionable"],
  "voiceContext": "Authoritative yet friendly, focused on practical SEO advice",
  "website_url": "https://clickflow.com",
  "brandColors": [],
  "guidelines": [],
  "imageStylePreference": "stock_photo",
  "sophistication": 50.0,
  "founded": "2017",
  "concepts": "",
  "constraints": "",
  "contentDifferentiation": "",
  "ctas": "",
  "examples": "",
  "knowledgeProducts": "",
  "statistics": ""
}

Usage

Call platform_get_brand_voice with no parameters.

curl https://api.clickflow.com/v1/api/brand-voice \
  -H "Authorization: Bearer cf_ak_your_key_here"

Returns {"error": "No brand voice configured for this organization"} if not set up yet. Configure it in the ClickFlow dashboard.

platform_analyze_keyword

Get keyword difficulty, search volume, and competition metrics via DataForSEO.

Parameters

Name	Type	Required	Default	Description
`keyword`	string	Yes	—	The keyword to analyze
`location`	string	No	`"United States"`	Target location
`language`	string	No	`"en"`	Language code

Response

{
  "keyword_difficulty": 65,
  "search_intent": null,
  "search_volume": 12000,
  "cpc": 4.50,
  "competition": 0.73,
  "trend_data": { "2025-12": 11000, "2026-01": 12500 },
  "serp_features": ["featured_snippet", "knowledge_graph", "people_also_ask"]
}

Usage

{
  "keyword": "best project management tools",
  "location": "United States"
}

curl -X POST https://api.clickflow.com/v1/api/analyze-keyword \
  -H "Authorization: Bearer cf_ak_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "best project management tools"}'

platform_list_target_keywords

List tracked target keywords with SEO metrics.

Parameters

Name	Type	Required	Default	Description
`limit`	integer	No	`500`	Maximum keywords to return

Response

{
  "keywords": [
    {
      "target_keyword": "best CRM for startups",
      "search_volume": 8100,
      "difficulty": 58,
      "intent": "commercial"
    }
  ],
  "count": 1
}

Usage

{ "limit": 100 }

curl "https://api.clickflow.com/v1/api/target-keywords?limit=100" \
  -H "Authorization: Bearer cf_ak_your_key_here"

If you have many keywords, the response may return {"error": "Too many keywords. Try a smaller limit."}. Reduce the limit parameter.

platform_list_competitors

List tracked competitors with domain, average position, and keyword intersections.

Parameters

None.

Response

{
  "competitors": [
    {
      "_id": "comp_abc123",
      "organizationId": "org_xyz789",
      "name": "Competitor Inc",
      "domain": "competitor.com",
      "avgPosition": 12.5,
      "intersections": 45,
      "tracked": true,
      "reasoning": "Direct competitor in SEO tools space",
      "createdAt": 1711234567890,
      "_creationTime": 1711234567890
    }
  ],
  "count": 1
}

Usage

Call platform_list_competitors with no parameters.

curl https://api.clickflow.com/v1/api/competitors \
  -H "Authorization: Bearer cf_ak_your_key_here"

Content

SEO

AI Agents

Analytics

Workflows

platform_get_brand_voice

Parameters

Response

Usage

platform_analyze_keyword

Parameters

Response

Usage

platform_list_target_keywords

Parameters

Response

Usage

platform_list_competitors

Parameters

Response

Usage

​platform_get_brand_voice

​Parameters

​Response

​Usage

​platform_analyze_keyword

​Parameters

​Response

​Usage

​platform_list_target_keywords

​Parameters

​Response

​Usage

​platform_list_competitors

​Parameters

​Response

​Usage

platform_get_brand_voice

Parameters

Response

Usage

platform_analyze_keyword

Parameters

Response

Usage

platform_list_target_keywords

Parameters

Response

Usage

platform_list_competitors

Parameters

Response

Usage