Integrations
cURL Examples
Quick cURL examples for all major Soke API endpoints.
cURL Examples
Replace sk_live_your_api_key with your actual API key in all examples.
Keyword Research
curl -X POST https://api.usesoke.ai/api/v1/research/keywords \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"topic": "productivity tips", "platform": "youtube"}'Content Research
curl -X POST https://api.usesoke.ai/api/v1/research/content \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"keywords": ["stoicism", "philosophy"], "platform": "youtube"}'Title Optimization
curl -X POST https://api.usesoke.ai/api/v1/content/optimize-title \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"draftTitle": "How to be productive", "platform": "youtube"}'Content Scoring
curl -X POST https://api.usesoke.ai/api/v1/content/score \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"content": "10 Tips for Better Code Reviews", "platform": "youtube"}'Description Generation
curl -X POST https://api.usesoke.ai/api/v1/content/generate-description \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"title": "10 Tips for Better Code Reviews", "keywords": ["code review", "programming"], "platform": "youtube"}'Tag Suggestions
curl -X POST https://api.usesoke.ai/api/v1/tags/suggest \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"title": "10 Tips for Better Code Reviews", "platform": "youtube"}'Chat Completions
curl -X POST https://api.usesoke.ai/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{
"messages": [{"role": "user", "content": "Research keywords for cooking tutorials and suggest 3 titles"}],
"platform": "youtube"
}'Trend Scan (async)
# Start the scan
curl "https://api.usesoke.ai/api/v1/trends/scan?niche=tech&platform=youtube" \
-H "X-Soke-Key: sk_live_your_api_key"
# Poll for results
curl "https://api.usesoke.ai/api/v1/jobs/JOB_ID" \
-H "X-Soke-Key: sk_live_your_api_key"Competitor Analysis (async)
# Start analysis
curl -X POST https://api.usesoke.ai/api/v1/competitor/analyze \
-H "Content-Type: application/json" \
-H "X-Soke-Key: sk_live_your_api_key" \
-d '{"urlOrChannel": "@competitor", "platform": "youtube"}'
# Poll for results
curl "https://api.usesoke.ai/api/v1/jobs/JOB_ID" \
-H "X-Soke-Key: sk_live_your_api_key"Check Credit Balance
curl https://api.usesoke.ai/api/v1/credits/balance \
-H "X-Soke-Key: sk_live_your_api_key"Check Usage
curl https://api.usesoke.ai/api/v1/usage/summary \
-H "X-Soke-Key: sk_live_your_api_key"