Zapier

Add a Webhooks action

In your Zap, add an action step:

1. Search for Webhooks by Zapier
2. Select Custom Request
3. Configure the fields:

Set headers

In the Headers field, add:

Content-Type: application/json
X-Soke-Key: sk_live_your_api_key

Each header goes on its own line in the format Key: Value.

Set the data payload

In the Data field, enter your JSON body:

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

To use dynamic data from a trigger or previous step, use Zapier's field mapping:

{
  "topic": "{{steps.trigger.topic}}",
  "platform": "youtube"
}

Test the step

Click Test step. Zapier will show the parsed response. You should see fields like:

• data__success: true
• data__data__keywords: (array of results)
• data__meta__processing_time_ms: (number)

Zapier flattens nested JSON with double underscores (__).

Trigger: New Spreadsheet Row

1. App: Google Sheets
2. Event: New Spreadsheet Row
3. Spreadsheet: Select your content planning spreadsheet
4. Worksheet: Select the sheet with your topics

The trigger fires when you add a new row with a topic in a designated column (e.g., Column A = "Topic").

Action: Research Keywords

1. App: Webhooks by Zapier
2. Event: Custom Request
3. Method: POST
4. URL: https://api.usesoke.ai/api/v1/research/keywords
5. Headers:

   Content-Type: application/json
   X-Soke-Key: sk_live_your_api_key

6. Data:

   {
     "topic": "{{steps.trigger.columnA}}",
     "platform": "youtube",
     "maxResults": 10
   }

Replace columnA with the actual column name from your spreadsheet.

Action: Update Spreadsheet Row

1. App: Google Sheets
2. Event: Update Spreadsheet Row
3. Row: Use the trigger's row number
4. Map fields:
   • Top Keyword column: {{steps.research_keywords.data__data__keywords[]keyword}} (first item)
   • Competition Score column: {{steps.research_keywords.data__data__keywords[]competitionScore}}
   • Trend Direction column: {{steps.research_keywords.data__data__keywords[]trendDirection}}
   • Long Tail Phrases column: {{steps.research_keywords.data__data__longTailPhrases}}

Step 1: Research Keywords

Webhooks by Zapier → Custom Request:

• Method: POST
• URL: https://api.usesoke.ai/api/v1/research/keywords
• Headers: Content-Type: application/json and X-Soke-Key: sk_live_...
• Data:

  {
    "topic": "your topic here",
    "platform": "youtube",
    "maxResults": 10
  }

Step 2: Extract Keywords with Formatter

Add a Formatter by Zapier step to extract keyword names:

1. Event: Utilities → Lookup Table (or use Text → Extract Pattern)
2. Map the keywords array from Step 1 into a comma-separated string

Alternatively, reference the first few keywords directly:

• {{steps.step1.data__data__keywords[]keyword}}

Step 3: Optimize Title

Webhooks by Zapier → Custom Request:

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

  {
    "draftTitle": "How to be productive as a developer",
    "platform": "youtube",
    "keywords": ["{{steps.step2.output}}"]
  }

Step 4: Generate Description

Webhooks by Zapier → Custom Request:

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

  {
    "title": "{{steps.step3.data__data__alternatives[]title}}",
    "platform": "youtube",
    "keywords": ["{{steps.step2.output}}"],
    "tone": "casual"
  }

Step 5: Output

Send results to your destination:

• Google Sheets: Update a row with the optimized title and description
• Slack: Post a message with the results
• Notion: Create a new page with the content

Map these fields:

• Optimized title: {{steps.step3.data__data__alternatives[]title}}
• Title score: {{steps.step3.data__data__alternatives[]overallScore}}
• Description: {{steps.step4.data__data__description}}

Start the async job

Webhooks by Zapier → Custom Request to start thumbnail generation or transcription (see Thumbnail or Transcription docs). For thumbnails, we recommend using a templateId from a saved thumbnail template for consistent styling — just pass the templateId, title, prompt, and platform. Supported resolutions: 1280x720 (landscape) or 1080x1920 (portrait/shorts).

Add a Delay

Use Delay by Zapier:

• Delay for: 30 seconds (thumbnails) or 60 seconds (transcription)

This gives the server time to process before polling.

Poll for status

Webhooks by Zapier → Custom Request:

• Method: GET
• URL: https://api.usesoke.ai/api/v1/thumbnail/{{steps.start_job.data__data__id}} (thumbnail) or https://api.usesoke.ai/api/v1/transcription/{{steps.start_job.data__data__id}} (transcription)
• Headers: X-Soke-Key: sk_live_...

Check completion with Paths

Use Paths by Zapier (requires Professional plan):

Path A — Completed:

• Condition: data__data__status is Completed (thumbnail) or completed (transcription)
• Continue to output step

Path B — Still processing:

• Condition: data__data__status is not Completed/completed
• Add another Delay + Poll step (Zapier doesn't support loops, so you'll need to chain additional delay+poll steps for reliability)