1.6.0
Routes for combing through a workspace, finding what stands out, and exporting it next to your own data. See Exploring and exporting.
POST /posts/match. Resolve up to 100 post links from a campaign tracker, creator list, or post-performance report to posts on your team. Each link comes back in order asmatched,processing,failed,not_in_workspace,invalid_url, orunsupported_platform, andmeta.matchedPostIdsdrops straight intoselection.postIds. Nothing is added or charged.POST /posts/scan. One row per post across a selection, against the selection’s comment-weighted baseline, with flags for negative sentiment, posts well below or above the baseline, commenters arguing with each other, off-topic threads, content-vs-topic gaps, and highly engaged negative posts. Sort, filter by flag, page, or take every row as CSV.POST /breakdowns. Roll a selection up by account, platform, content tag, content type, collection, week, or month — the same math as the dashboard’s combined-by-account rows — with each group’s share of the selection and its difference from it.- Comparisons.
POST /analysestakescompare— 2 to 4 labeled selections — instead ofselection. Each side gets its own scope, content, and comment analysis;comparison.deltasgives each side against side 1.GET /analyses/{id}/comments?side=Nsamples one side. - Cited answers.
answer: { question }(oranswer: truefor an overview) writes the finding in words, with every claim citing real comments that resolve incommentAnalysis.answer.citations. Always a job, in theanalysis_searchrate class. If the writer fails, the numbers are still ready andanswer.errorexplains. - Scores over Time.
include: ["timeline"]adds the dashboard chart’s series over the matched comments, by day, week, or month, by comment date or post date, in your time zone. - Languages.
filters.languagesnarrows to comments that contain (contains) or are only in (only) the listed languages;include: ["languages"]adds a language breakdown. GET /analyses/{id}/export. Flatposts,sides,timeline,languages, andcitationstables as JSON or CSV. Thepoststable carries the same join keys as scan and match rows. Every analysis links it asexport.url.- Answers need
comments:read. Requestinganswerwithout it is a403, and a key without it that reads an analysis gets citations as ids and post links only. GET /analyses?kind=comparisonlists comparisons.- New rate classes:
posts_scan,breakdowns,posts_match(20 / minute, 500 / day each) andanalysis_export(30 / minute, 500 / day).GET /melists them underrateLimit.routeClasses.
MCP (beta)
The Analyst API is also available as an MCP, in beta, at POST /mcp on https://api.siftsy.app. Same key, same scopes, same rate classes. Tool names and shapes can still change; /analyst/v1 stays the stable warehouse contract. See MCP (beta).
