Source

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
tiktok	url	Extract TikTok transcript
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"
  }
}

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

In the official Blotato nodes:

1. Add a Blotato node

2. Select "Source" > "Create"

3. Choose your source type

4. Pass the output source ID to a "Get Source" node to retrieve content