Make (Integromat)

Add an HTTP module

In your scenario, click the + button and search for HTTP. Select HTTP → Make a request.

Configure the request

Fill in the following fields:

Headers to add:

Enable response parsing

Check the Parse response checkbox. This lets you access response fields directly in subsequent modules without needing a separate JSON parse step.

Test the module

Click Run this module only. You should see a response with data.success: true and your keyword results under data.data.keywords.

Module 1: HTTP → Make a request

• URL: https://api.usesoke.ai/api/v1/research/keywords
• Method: POST
• Headers: Content-Type: application/json, X-Soke-Key: sk_live_...
• Body type: Raw
• Content type: JSON
• Request content:

{
  "topic": "productivity tips for developers",
  "platform": "youtube",
  "maxResults": 20
}

• Parse response: ✅ Checked

Module 2: Iterator (optional)

If you want to process each keyword individually, add an Iterator module:

• Array: data.data.keywords

This creates one bundle per keyword, letting you map individual fields like keyword, competitionScore, trendDirection in downstream modules.

Module 3: Output

Connect to your destination:

• Google Sheets: Map keyword, competitionScore, trendDirection, searchVolume to columns
• Airtable: Create records with keyword data
• Slack: Send a formatted summary of top keywords

Module 1: Research Keywords

HTTP module configured as above with your topic.

Module 2: Optimize Title

Add a second HTTP module:

• URL: https://api.usesoke.ai/api/v1/content/optimize-title
• Method: POST
• Request content:

{
  "draftTitle": "How to boost your productivity as a developer",
  "platform": "youtube",
  "keywords": {{toJSON(map(slice(1.data.data.keywords; 0; 5); "keyword"))}}
}

This extracts the top 5 keyword names from Module 1's response and passes them to the title optimizer.

Module 3: Generate Description

Add a third HTTP module:

• URL: https://api.usesoke.ai/api/v1/content/generate-description
• Method: POST
• Request content:

{
  "title": "{{2.data.data.alternatives[1].title}}",
  "platform": "youtube",
  "keywords": {{toJSON(map(slice(1.data.data.keywords; 0; 5); "keyword"))}},
  "niche": "tech",
  "tone": "casual"
}

This uses the best optimized title from Module 2 and the keywords from Module 1.

Module 4: Output

Add a Set variable or connect directly to Google Sheets/Notion:

• Optimized title: {{2.data.data.alternatives[1].title}}
• Title score: {{2.data.data.alternatives[1].overallScore}}
• Description: {{3.data.data.description}}

Module 1: Start the job

Thumbnail generation:

• URL: https://api.usesoke.ai/api/v1/thumbnail/generate
• Method: POST
• Request content:

Using a template (recommended — create one in the Soke dashboard for consistent styling):

{
  "manualTitle": "10 Developer Productivity Hacks",
  "manualPrompt": "A developer at a clean desk with multiple monitors",
  "templateId": "your-template-id",
  "platform": "youtube"
}

Or without a template (all parameters required). Supported resolutions: 1280x720 (landscape) or 1080x1920 (portrait/shorts):

{
  "manualTitle": "10 Developer Productivity Hacks",
  "manualPrompt": "A developer at a clean desk with multiple monitors",
  "colorGrading": "Cinematic",
  "layoutType": "TextCenter",
  "resolution": "1280x720",
  "platform": "youtube"
}

Transcription:

• URL: https://api.usesoke.ai/api/v1/transcription
• Method: POST
• Body type: Multipart/form-data
• Fields: url = https://youtube.com/watch?v=VIDEO_ID

Module 2: Repeater

Add a Flow Control → Repeater module:

• Initial value: 1
• Repeats: 10 (maximum polling attempts)

This creates a loop that runs up to 10 times.

Module 3: Sleep

Add a Tools → Sleep module:

• Delay: 5 (seconds for thumbnails) or 10 (seconds for transcription)

Module 4: Poll status

Add an HTTP module:

Thumbnail:

• URL: https://api.usesoke.ai/api/v1/thumbnail/{{1.data.data.id}}
• Method: GET

Transcription:

• URL: https://api.usesoke.ai/api/v1/transcription/{{1.data.data.id}}
• Method: GET

Module 5: Router

Add a Flow Control → Router module with two routes:

Route 1 — Completed:

• Filter: data.data.status equals Completed (thumbnail) or completed (transcription)
• Action: Set variable or send to output

Route 2 — Still processing:

• Filter: data.data.status does not equal Completed/completed
• Action: Continue (the repeater loop handles retries automatically)