# Siftsy Analyst API Instructions for AI Agents: - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.docs.siftsy.com/_mcp/server ## Docs - [Siftsy Analyst API](https://api.docs.siftsy.com/guides/get-started/overview.md): Put Siftsy's comment intelligence in your analyst workflow: add the posts you need to read, run analyses, and export key insights into your reporting, warehouse, or AI chat. - [Quickstart](https://api.docs.siftsy.com/guides/get-started/quickstart.md): Get a Siftsy Analyst API key and make your first requests. - [MCP (beta)](https://api.docs.siftsy.com/guides/get-started/mcp-beta.md): Beta. Use your Analyst API key from Cursor, Claude, or ChatGPT to read how audiences reacted to a campaign, a viral moment, or a competitor, add new posts, and pull the numbers and quotes for your report. - [Authentication](https://api.docs.siftsy.com/guides/core-concepts/authentication.md): Team API keys, scopes, and request headers. - [Rate limits](https://api.docs.siftsy.com/guides/core-concepts/rate-limits.md): Per-key budgets sized for a scheduled BI refresh: up to eight full workspace refreshes a day, or one full refresh plus hourly incrementals. - [Pagination and envelopes](https://api.docs.siftsy.com/guides/core-concepts/pagination.md): Cursor pages, response shape, and error bodies in the Siftsy Analyst API. - [Content selection](https://api.docs.siftsy.com/guides/core-concepts/content-selection.md): What a selection is, the four ways to make one, and why the same selection drives both post listings and analyses. - [Filtering posts](https://api.docs.siftsy.com/guides/core-concepts/filtering-posts.md): Find exactly the posts you want by link, account, platform, date, Siftsy score, or sentiment. - [Analyses](https://api.docs.siftsy.com/guides/core-concepts/analyses.md): What an analysis is, the kinds Siftsy produces, how filtering and search narrow it, and why some analyses are jobs. - [Exploring and exporting](https://api.docs.siftsy.com/guides/core-concepts/exploring.md): Comb through a workspace, find what stands out, back it with comments, and export tables that join with your own data. - [Post analysis](https://api.docs.siftsy.com/guides/core-concepts/post-analysis.md): Content analysis plus comment analysis for one post — and the comments that belong to that analysis. - [Scores](https://api.docs.siftsy.com/guides/core-concepts/scores.md): What Sentiment, Content, Topic, Relevance, and Consensus actually measure — and how they roll up into the Siftsy Score. - [Retrieving comments](https://api.docs.siftsy.com/guides/core-concepts/retrieving-comments.md): Sample the comments behind an analysis, then narrow that sample by mix-bar bucket. - [Adding content](https://api.docs.siftsy.com/guides/core-concepts/adding-content.md): Add posts by URL or pull a public account's recent posts into your team — the same as Add New in Siftsy, programmatically. - [BI sync](https://api.docs.siftsy.com/guides/core-concepts/bi-sync.md): Export key analyses and insights into your data warehouse or data platform: a suggested load order for Snowflake, BigQuery, Databricks, Redshift, and BI tools. - [API reference](https://api.docs.siftsy.com/api-reference/overview/api-reference.md): Every Siftsy Analyst API endpoint, with examples you can run. - [Changelog](https://api.docs.siftsy.com/changelog/llms.txt) ## API Docs - [Key identity and rate limit](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-me.md): Siftsy Analyst API - [Team metadata and analysis settings](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-team.md): Siftsy Analyst API - [List collections](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-collections.md): Siftsy Analyst API - [Get a collection](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-collection.md): Siftsy Analyst API - [List posts in a collection](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-collection-posts.md): Siftsy Analyst API - [List posts](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-posts.md): Siftsy Analyst API - [Get a post](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-post.md): Siftsy Analyst API - [Get a post's aggregate score metrics](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-post-metrics.md): Siftsy Analyst API - [Get a post's content and comment analysis](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-post-analysis.md): Siftsy Analyst API - [Sample comments behind a post analysis](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-analysis-comments.md): Siftsy Analyst API - [Match links from your own data to posts](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/match-posts.md): Siftsy Analyst API - [Scan a selection for posts that stand out](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/scan-posts.md): Siftsy Analyst API - [Break a selection down by account, platform, tag, type, collection, or period](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/breakdown-posts.md): Siftsy Analyst API - [List saved analyses from the Siftsy app](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-snapshots.md): Siftsy Analyst API - [Get a saved analysis from the Siftsy app](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-insights.md): Siftsy Analyst API - [Create an analysis from a content selection](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/create-analysis.md): Siftsy Analyst API - [List analyses](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-analyses.md): Siftsy Analyst API - [Get an analysis](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-analysis.md): Siftsy Analyst API - [Sample comments behind an analysis](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-persisted-analysis-comments.md): Siftsy Analyst API - [Export an analysis as a flat table](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/export-analysis.md): Siftsy Analyst API - [Add posts by URL](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/add-posts.md): Siftsy Analyst API - [Add a public account's recent posts](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/add-account.md): Siftsy Analyst API - [Refresh posts already on the team](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/refresh-posts.md): Siftsy Analyst API - [List content jobs](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/list-content-jobs.md): Siftsy Analyst API - [Get a content job](https://api.docs.siftsy.com/api-reference/siftsy-analyst-api/get-content-job.md): Siftsy Analyst API ## OpenAPI Specification - [OpenAPI JSON](https://api.docs.siftsy.com/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://api.docs.siftsy.com/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format