Source extraction requests

Submit REST source extraction with an explicit source type and stop on completed or failed results.

Compact reference for agents making REST requests. All endpoint paths below are relative to https://backend.blotato.com/v2. For task instructions, read the workflow guide. For tool calls, use the MCP reference.

Extracting content (sources)

POST /source-resolutions-v3

Body MUST contain a "source" object. Do NOT put fields at the top level.

source.sourceType (REQUIRED, no auto-detection):
- "text"             - Transform raw text (uses source.text)
- "article"          - Extract from article URL (uses source.url)
- "youtube"          - Extract from YouTube URL (uses source.url)
- "twitter"          - Extract from Twitter/X URL (uses source.url)
- "tiktok"           - Extract from TikTok URL (uses source.url)
- "perplexity-query" - AI web research (uses source.text)
- "audio"            - Extract from audio URL (uses source.url)
- "pdf"              - Extract from PDF URL (uses source.url)

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

WRONG (missing "source" wrapper):
{ "sourceType": "youtube", "url": "..." }

Response: { "id": "src_123" }
Save response.id. Acceptance is not extraction completion.

Poll: GET /source-resolutions-v3/{id}
Wait at least 10 seconds between checks, within a bounded client wait budget.
Status values: "queued" | "processing" | "completed" | "failed"
"queued" or "processing": continue checking the saved ID within the wait budget.
"completed": response includes "content" and "title". Use the extracted content.
"failed": stop and report response.message. Do not continue as if content was extracted.
Timeout: report the saved ID and pending state. Resume lookup, not another create request.

Extraction does not generate media or publish a post. Continue only with the work requested by the user. See Extract and adapt source content.

Return to the agent reference index.