Source

Submit a typed URL or text source for extraction and retain its ID for completion checks.

Submit content for extraction and receive a source ID for polling.

Endpoint

POST https://backend.blotato.com/v2/source-resolutions-v3

Rate Limit: 30 requests / minute

Authentication

Include your Blotato API key in the request headers:

blotato-api-key: YOUR_API_KEY

Source Types

Value	Requires	Description
youtube	url	Extract YouTube transcript (English captions only)
tiktok	url	Extract TikTok transcript (English captions only)
article	url	Extract article text from a web page
pdf	url	Extract text from a PDF
audio	url	Transcribe audio (mp3, wav, m4a, ogg, flac, aac)
twitter	url	Extract tweet content
text	text	Transform raw text content with optional AI instructions
perplexity-query	text	AI-powered web research query

Parameters

Parameter	Type	Required	Description
source.sourceType	string	Yes	One of: youtube, tiktok, article, pdf, audio, twitter, text, perplexity-query
source.url	string	Required for URL-based types	The URL to extract content from
source.text	string	Required for text and perplexity-query	Raw text or search query
customInstructions	string	No	AI instructions to transform extracted content

Examples

Extract YouTube Transcript

{
  "source": {
    "sourceType": "youtube",
    "url": "https://www.youtube.com/watch?v=VIDEO_ID"
  }
}

YouTube and TikTok transcript extraction reads English captions only. A non-English video, or a video with no captions, returns a failed status. For those videos, pass the transcript or a summary using sourceType: "text" instead.

Extract Article with Custom Instructions

{
  "source": {
    "sourceType": "article",
    "url": "https://example.com/article"
  },
  "customInstructions": "Summarize in 5 bullet points"
}

AI Research Query

{
  "source": {
    "sourceType": "perplexity-query",
    "text": "latest AI trends in social media marketing"
  }
}

Transform Raw Text

{
  "source": {
    "sourceType": "text",
    "text": "Your raw content here..."
  },
  "customInstructions": "Rewrite as a Twitter thread"
}

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Use this ID with the Get Source endpoint to retrieve the extracted content.

n8n and Make.com

1. In n8n, select Source > Create.

2. Save the returned id.

3. Use Source > Get to check the saved ID until status is completed or failed.

4. Read content after completed, or report message after failed.

Follow the n8n polling instructions or the source-to-publication workflow.

For Make, follow the Make setup guide. Inspect the installed module's fields or use the async REST contract. n8n operation labels do not establish Make module labels.