API v1.0

Tircha API Documentation

Generate SEO-optimized blog articles and discover profitable keywords programmatically. Simple REST API, JSON responses, works with any language.

Get API Key →Contact Support

Base URL

https://tircha-backend-production.up.railway.app

Authentication

All API requests require your API key passed in the request header. Get your key by subscribing at tircha.com/pricing.

# Add this header to every request
X-API-Key: tircha_your_api_key_here

⚠️ Never expose your API key in frontend code or public repositories.

Rate Limits

Starter

10 req/day

View plan →

Pro

50 req/day

View plan →

Agency

200 req/day

View plan →

Limits reset every day at midnight UTC. Upgrade anytime at tircha.com/pricing.

Endpoints

POST/api/blog/generate

Generate a complete SEO blog article for any keyword

Request Body

{
  "keyword": "best VPN for gaming 2026",
  "niche": "software",
  "length": "medium"
}

Response

{
  "success": true,
  "keyword": "best VPN for gaming 2026",
  "title": "Best VPN for Gaming in 2026",
  "meta_description": "Expert guide about best VPN...",
  "content_markdown": "# Best VPN for Gaming...",
  "word_count": 847,
  "requests_used": 1,
  "requests_remaining": 49,
  "plan": "pro"
}

POST/api/keywords/research

Get profitable keyword ideas for any seed topic

Request Body

{
  "seed": "gaming headset",
  "niche": "gaming",
  "limit": 20
}

Response

{
  "success": true,
  "seed": "gaming headset",
  "keywords": [
    {
      "keyword": "best gaming headset under 100",
      "intent": "commercial",
      "difficulty": "low",
      "opportunity_score": 85
    }
  ],
  "total_found": 47,
  "requests_remaining": 48
}

GET/health

Check if the API is online

Response

{ "status": "ok" }

Parameters Reference

niche

Tells the AI which topic area to write for. Affects tone and examples used.

tradingai-toolssoftwaregamingfinancehealtheducationtravel

length

Target word count for generated articles.

short~600 words

medium~900 words

long~1400 words

Code Examples

Python

import requests

response = requests.post(
    "https://tircha-backend-production.up.railway.app/api/blog/generate",
    headers={"X-API-Key": "tircha_your_key"},
    json={
        "keyword": "best gaming headset under $100",
        "niche": "gaming",
        "length": "medium"
    }
)

article = response.json()
print(article["title"])
print(article["content_markdown"])

JavaScript / Node.js

const response = await fetch(
  "https://tircha-backend-production.up.railway.app/api/blog/generate",
  {
    method: "POST",
    headers: {
      "X-API-Key": "tircha_your_key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      keyword: "best gaming headset under $100",
      niche: "gaming",
      length: "medium"
    })
  }
)

const article = await response.json()
console.log(article.title)

cURL

curl -X POST \
  https://tircha-backend-production.up.railway.app/api/blog/generate \
  -H "X-API-Key: tircha_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"best VPN for gaming","niche":"software"}'

Error Codes

Code	Meaning	Fix
401	Invalid API key	Check your key at tircha.com/pricing
403	Subscription inactive	Renew at tircha.com/pricing
429	Daily limit reached	Upgrade plan or wait until midnight UTC
400	Bad request	Check your keyword is at least 3 characters
503	Generation failed	Retry the request — AI model was busy

Ready to start building?

Get your API key and generate your first article in under 2 minutes.

View Pricing & Get API Key →