Recent channel corpus
Use channel_id to search up to 20 collected videos from the past 30 days.
API v1.2 · MCP
TubeSignal Evidence agent integration guide
Everything an agent needs to select the capability, build a valid request, verify evidence, and handle failures safely.
Choose the query target
One video
Use video_url. Sending both target fields returns HTTP 400.
Multiple findings
Set answer_count from 2 to 4. Each answer includes evidence_indices.
REST quickstart
curl -X POST https://tubesignal.net/api/v1/evidence/query \
-H "Content-Type: application/json" \
-H "Idempotency-Key: research-2026-09-11-001" \
-d '{"channel_id":"UC6kZpTl39-_SqfBrF1-N2oQ","question":"Which market factors were repeatedly mentioned over the past month?","response_language":"en","answer_count":3,"evidence_limit":6}'Read the response
{
"status": "answered",
"answer": "... [1] [3]",
"answers": [
{ "id": "answer-1", "title": "...", "answer": "...", "evidence_indices": [1, 3] },
{ "id": "answer-2", "title": "...", "answer": "...", "evidence_indices": [2] }
],
"evidence": [
{ "text": "original transcript", "translated_text": "optional translation", "watch_url": "https://youtu.be/...?..." }
],
"external_truth_status": "not_evaluated"
}answer- The backwards-compatible overview.
answers- Distinct findings. evidence_indices are one-based positions in evidence.