Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.
Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.
Up to AlertPreviewSampleSize most-recent matches with payload fully hydrated. Empty until status is completed.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Particle API","colors":{"primary":"#0369a1","light":"#0369a1","dark":"#0369a1"},"logo":{"light":"https://mintcdn.com/particle-c40da4e2/tk5mmLn_iJIxNhbI/logo/light.svg?fit=max\u0026auto=format\u0026n=tk5mmLn_iJIxNhbI\u0026q=85\u0026s=a659784e597694177292b154cc1808f4","dark":"https://mintcdn.com/particle-c40da4e2/i9nEIhB1W5dtahvW/logo/dark.svg?fit=max\u0026auto=format\u0026n=i9nEIhB1W5dtahvW\u0026q=85\u0026s=53bcea9f9026f0bf0083447adbc1d006"},"favicon":"https://mintcdn.com/particle-c40da4e2/tk5mmLn_iJIxNhbI/favicon.png?fit=max\u0026auto=format\u0026n=tk5mmLn_iJIxNhbI\u0026q=85\u0026s=f4b42e6e90da406c6f1e6b4b8615113c","api":{"examples":{"languages":["curl","bash"],"autogenerate":false}},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#0C0D0D"}},"navbar":{"links":[{"href":"https://status.particle.pro","label":"Status"},{"href":"mailto:api@particle.pro","label":"Support"}],"primary":{"type":"button","label":"API Dashboard","href":"https://platform.particle.pro"}},"footer":{"socials":{"x":"https://x.com/particle_news","github":"https://github.com/particlepro","linkedin":"https://linkedin.com/company/particle-news"}},"fonts":{"family":"Geist","weight":400},"styling":{"codeblocks":"dark","latex":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor","vscode",{"title":"Connect Particle Pro MCP","description":"Install the Particle Pro MCP server in your AI client","icon":"plug","href":"/mcp/quickstart"},{"title":"Set up an AI agent","description":"Hand your agent agents.md and it connects itself","icon":"robot","href":"https://api.particle.pro/agents.md"}],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"particle-c40da4e2","hasAudioNarration":false,"actualSubdomain":"particle-c40da4e2","customDomains":["docs.particle.pro"],"gitSource":{"type":"github","owner":"mongoosehq","repo":"api","deployBranch":"main","contentDirectory":"server/particlepro/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae50444bbaf7eb08d127dd1","collectionId":"a4bcb438-95e1-4f42-a5b0-5c37fe24cb33","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae50444bbaf7eb08d127dd1"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae50444bbaf7eb08d127dd1","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API reference","count":169},{"language":"default","tag":"Guides","count":126},{"language":"default","tag":"Errors","count":70},{"language":"default","tag":"MCP server","count":58},{"language":"default","tag":"Podcasts","count":58},{"language":"default","tag":"Tools","count":51},{"language":"default","tag":"Billing \u0026 subscription","count":30},{"language":"default","tag":"Alerts","count":27},{"language":"default","tag":"People","count":21},{"language":"default","tag":"Companies","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"api@particle.news","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}html.dark #mdx-content,html.dark #page-title,html.dark h1,html.dark h2,html.dark h3{color:rgba(255,255,255,.9)}html.dark #sidebar a,html.dark .accordion,html.dark [class*=tooltip]{color:rgba(255,255,255,.6)}html.dark .method-pill,html.dark [class*=admonition] p,html.dark [class*=breadcrumb],html.dark [class*=callout] p,html.dark [class*=eyebrow]{color:rgba(255,255,255,.5)}html.dark footer,html.dark footer *{color:rgba(255,255,255,.2)}html.dark .accordion,html.dark .card,html.dark .code-block,html.dark .steps,html.dark .tabs{border-color:rgba(255,255,255,.15)}html.dark .card{border-radius:.75rem}html.dark .code-block{border-radius:.5rem}html.dark .code-block pre{background-color:#1a1b1b}.dark\\:border-white\\/\\[0\\.07\\]:is(.dark *){border-color:rgba(255,255,255,.15)}html.dark #sidebar{background-color:#0c0d0d;border-color:rgba(255,255,255,.15)}html.dark,html.dark *{scrollbar-width:thin;scrollbar-color:rgba(255,255,255,.15) transparent}html.dark ::-webkit-scrollbar,html.dark::-webkit-scrollbar{width:6px;height:6px}html.dark ::-webkit-scrollbar-track,html.dark::-webkit-scrollbar-track{background:0 0}html.dark ::-webkit-scrollbar-thumb,html.dark::-webkit-scrollbar-thumb{background:rgba(255,255,255,.15);border-radius:3px}html.dark ::-webkit-scrollbar-thumb:hover,html.dark::-webkit-scrollbar-thumb:hover{background:rgba(255,255,255,.3)}"}],"page":{"pagePath":"api-reference/alerts/get-the-status-and-result-of-an-alert-preview","slug":"/api-reference/alerts/get-the-status-and-result-of-an-alert-preview","pageMetadata":{"title":"Get the status and result of an alert preview","description":"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/preview/{previewId}","href":"/api-reference/alerts/get-the-status-and-result-of-an-alert-preview","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,strong:`strong`,..._provideComponents(),...props.components},{Tip}=_components;if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(Tip,{children:[`Prefer the terminal? This endpoint is also a command in the Particle CLI: pick `,_jsx(_components.strong,{children:`Particle CLI`}),` in the request example’s language menu. `,_jsx(_components.a,{href:`https://cli.particle.pro`,children:`Install the Particle CLI`}),`.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Get the status and result of an alert preview","description":"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/preview/{previewId}","href":"/api-reference/alerts/get-the-status-and-result-of-an-alert-preview","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.","operationId":"get-alert-preview","parameters":["63bf4956-c32b-4deb-bec8-532b176c61a6"],"responses":{"200":"c672dc86-3e12-4166-9f25-856d876886cd","default":"8185d3b5-9e66-4464-8db8-0e0a91c449cf"},"summary":"Get the status and result of an alert preview","tags":["Alerts","tier:standard"],"x-codeSamples":[{"label":"cURL","lang":"curl","source":"curl -H \"X-API-Key: $PARTICLE_API_KEY\" \\\n \"https://api.particle.pro/v1/alerts/preview/{previewId}\""},{"label":"Particle CLI","lang":"bash","source":"# Install: https://cli.particle.pro\nparticle alert preview-result \u003cpreviewId>"}],"x-cost-weight":1,"x-entitlement-priced":true,"x-mint":{"content":"\u003cTip>Prefer the terminal? This endpoint is also a command in the Particle CLI: pick **Particle CLI** in the request example's language menu. [Install the Particle CLI](https://cli.particle.pro).\u003c/Tip>"},"x-pagination":"none","x-tier":"standard","method":"get","type":"path","servers":["bc7c60ad-8b90-43eb-b968-32aa4dec56b4"],"security":["a5428769-866c-42c7-a004-c213d9b7ee43","0ced4d8f-1c3f-4d2a-8de5-c63f277c6d53"],"path":"/v1/alerts/preview/{previewId}","baseUrlOptions":["https://api.particle.pro"],"title":"Get the status and result of an alert preview","codeSamples":[{"label":"cURL","lang":"curl","source":"curl -H \"X-API-Key: $PARTICLE_API_KEY\" \\\n \"https://api.particle.pro/v1/alerts/preview/{previewId}\""},{"label":"Particle CLI","lang":"bash","source":"# Install: https://cli.particle.pro\nparticle alert preview-result \u003cpreviewId>"}],"requestExampleLanguages":["bash","bash"],"requiredOnlyExamples":false,"disableCodeSampleGeneration":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"63bf4956-c32b-4deb-bec8-532b176c61a6":{"description":"Opaque preview ID returned by POST /v1/projects/{projectId}/alerts/preview.","in":"path","name":"previewId","required":true,"schema":{"description":"Opaque preview ID returned by POST /v1/projects/{projectId}/alerts/preview.","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"c672dc86-3e12-4166-9f25-856d876886cd":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"started_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time>"},"status":{"description":"State of the sweep. Clients should poll until the value is 'completed' or 'failed' (TTL 1h).","enum":["in_progress","completed","failed"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"total_matches":{"format":"int64","type":"integer","isRequired":true,"uniqueKey":"total_matches","typeLabel":"integer\u003cint64>"},"window_days":{"format":"int64","type":"integer","isRequired":true,"uniqueKey":"window_days","typeLabel":"integer\u003cint64>"},"by_day":{"oneOf":[{"description":"Per-day match count over the window (UTC dates), oldest day first.","items":{"additionalProperties":false,"properties":{"count":{"description":"Number of matches whose source episode aired on that day.","format":"int64","type":"integer","isRequired":true,"uniqueKey":"by_day.oneOf.0.items.[INDEX].count","typeLabel":"integer\u003cint64>"},"date":{"description":"UTC date in YYYY-MM-DD format.","type":"string","isRequired":true,"uniqueKey":"by_day.oneOf.0.items.[INDEX].date","typeLabel":"string"}},"required":["date","count"],"type":"object","uniqueKey":"by_day.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"by_day.oneOf.0","typeLabel":"object[]"},{"description":"Per-day match count over the window (UTC dates), oldest day first.","items":{"additionalProperties":false,"properties":{"count":{"description":"Number of matches whose source episode aired on that day.","format":"int64","type":"integer"},"date":{"description":"UTC date in YYYY-MM-DD format.","type":"string"}},"required":["date","count"],"type":"object"},"type":"null","uniqueKey":"by_day.oneOf.1","typeLabel":"null"}],"uniqueKey":"by_day","typeLabel":"object[] | null"},"completed_at":{"description":"Set once status is completed or failed.","format":"date-time","type":"string","uniqueKey":"completed_at","typeLabel":"string\u003cdate-time>"},"error":{"description":"Set only when status is failed; safe to surface to the user.","type":"string","uniqueKey":"error","typeLabel":"string"},"sample":{"oneOf":[{"description":"Up to AlertPreviewSampleSize most-recent matches with payload fully hydrated. Empty until status is completed.","items":{"additionalProperties":false,"properties":{"alert_id":{"description":"ID of the parent alert.","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].alert_id","typeLabel":"string"},"deliveries":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"channel":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].channel","typeLabel":"string"},"created_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"id":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].id","typeLabel":"string"},"status":{"description":"Delivery outcome — SENT (delivered; a partial success keeps this status with the failure noted in error_message), FAILED (an attempt failed; realtime retries within its budget and digests re-select within their window), SKIPPED (intentionally not delivered), or ABANDONED (realtime webhook delivery permanently gave up after exhausting its retry budget, so the match was dropped for that channel).","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].status","typeLabel":"string"},"error_message":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].error_message","typeLabel":"string"},"sent_at":{"format":"date-time","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX].sent_at","typeLabel":"string\u003cdate-time>"}},"required":["id","channel","status","created_at"],"type":"object","uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"error_message":{"type":"string"},"id":{"type":"string"},"sent_at":{"format":"date-time","type":"string"},"status":{"description":"Delivery outcome — SENT (delivered; a partial success keeps this status with the failure noted in error_message), FAILED (an attempt failed; realtime retries within its budget and digests re-select within their window), SKIPPED (intentionally not delivered), or ABANDONED (realtime webhook delivery permanently gave up after exhausting its retry budget, so the match was dropped for that channel).","type":"string"}},"required":["id","channel","status","created_at"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].deliveries","typeLabel":"object[] | null"},"detected_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].detected_at","typeLabel":"string\u003cdate-time>"},"entity_id":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].entity_id","typeLabel":"string"},"entity_type":{"description":"Type of the watched target: PERSON, COMPANY, or KNOWLEDGE_GRAPH_ENTITY for entity alerts, KEYWORD for KEYWORD_MENTION alerts.","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].entity_type","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].id","typeLabel":"string"},"kind":{"description":"Inherited from the parent alert's kind so clients can render mention vs appearance semantics without a follow-up alert lookup. Match payloads from ENTITY_MENTION and KEYWORD_MENTION alerts carry mention_count and mention_variants; PODCAST_SPEAKER matches carry roles and a line-count in mention_count.","enum":["ENTITY_MENTION","PODCAST_SPEAKER","KEYWORD_MENTION"],"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"mention_count":{"format":"int64","type":"integer","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].mention_count","typeLabel":"integer\u003cint64>"},"monitor_id":{"description":"Deprecated — use alert_id. ID of the parent alert.","type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].monitor_id","typeLabel":"string"},"source_id":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].source_id","typeLabel":"string"},"source_type":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].source_type","typeLabel":"string"},"episode":{"additionalProperties":false,"properties":{"podcast_id":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_id","typeLabel":"string"},"podcast_title":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_title","typeLabel":"string"},"title":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].episode.title","typeLabel":"string"},"apple_podcasts_url":{"description":"Apple Podcasts deep-link for the parent podcast. Omitted when the podcast has no iTunes ID.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.apple_podcasts_url","typeLabel":"string"},"audio_url":{"description":"CDN-fronted URL for the full episode audio, playable directly in a browser \u003caudio> element without auth (the podcast's own public media). Clients play a specific window by loading this and seeking to the window's start_seconds. Omitted when the episode has no stored audio yet. Present on both the member and public landing-page tiers so a shared link can play the clip.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.audio_url","typeLabel":"string"},"duration_seconds":{"description":"Total episode duration in seconds. Omitted when unknown.","format":"double","type":"number","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.duration_seconds","typeLabel":"number\u003cdouble>"},"explicit":{"description":"Whether the episode is flagged as containing explicit content by its publisher.","type":"boolean","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.explicit","typeLabel":"boolean"},"image_url":{"description":"Episode-specific image. Omitted when the episode has no dedicated image. Clients should fall back to podcast_image_url for a card thumbnail in that case.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.image_url","typeLabel":"string"},"podcast_bias":{"description":"Political bias rating for the parent podcast. Omitted when the podcast is not substantively political or has not been evaluated yet. Fetch GET /v1/podcasts/{id}/bias for the full analysis including reasoning and evidence.","enum":["EXTREME_LEFT","LEANS_LEFT","LEFT","CENTER","RIGHT","LEANS_RIGHT","EXTREME_RIGHT"],"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_bias","typeLabel":"enum\u003cstring>"},"podcast_image_url":{"description":"Parent podcast's image. Suitable as a fallback when image_url is absent.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_image_url","typeLabel":"string"},"podcast_popularity":{"description":"Parent podcast's global popularity percentile in (0,1] — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts charts). Higher is more popular; 1.0 is the most popular show. Omitted when the podcast is not currently charting.","format":"double","type":"number","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_popularity","typeLabel":"number\u003cdouble>"},"podcast_popularity_badge":{"description":"Human-facing reach tier derived from podcast_popularity: Top Podcast (top 1%), Very Popular (top 5%), or Popular (top 10%). Omitted for shows outside the top 10%.","enum":["Top Podcast","Very Popular","Popular"],"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_popularity_badge","typeLabel":"enum\u003cstring>"},"podcast_slug":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.podcast_slug","typeLabel":"string"},"published_at":{"format":"date-time","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.published_at","typeLabel":"string\u003cdate-time>"},"slug":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].episode.slug","typeLabel":"string"}},"required":["title","podcast_id","podcast_title"],"type":"object","description":"Optional episode + podcast metadata embedded so a single response renders a card without a follow-up /v1/episodes/{id} call. Populated for preview-sample matches (POST /v1/projects/{projectId}/alerts/preview's GET response) and for the landing-page GETs (GET /v1/alerts/deliveries/{id} in both summary and detailed views, GET /v1/alerts/matches/{id}); absent on the paginated live matches list.","uniqueKey":"sample.oneOf.0.items.[INDEX].episode","typeLabel":"object"},"is_backfilled":{"description":"True for matches written by the post-create historical sweep. Backfilled matches are real matches the live pipeline would have produced, with DetectedAt set to the source episode's publish time. They never trigger delivery (no email is sent) — the field lets the UI label them so users can distinguish 'past' from 'going-forward' matches.","type":"boolean","uniqueKey":"sample.oneOf.0.items.[INDEX].is_backfilled","typeLabel":"boolean"},"keyword":{"description":"KEYWORD_MENTION matches only: the phrase this match fired on. It stays the phrase that matched even if the alert's keyword is later edited.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].keyword","typeLabel":"string"},"llm_summary":{"description":"AI-generated narrative summary of this match with prior-mention context from the past 7 days for the same (alert, entity). Generated asynchronously after match creation. Absent (field omitted) when the summarizer hasn't processed the row yet OR when the LLM exhausted its retry budget — clients should treat both states the same: no summary to render. Visible to both org members and the public landing-page tier; the summary describes the mention itself, not the alert configuration.","type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].llm_summary","typeLabel":"string"},"mention_variants":{"oneOf":[{"items":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].mention_variants.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"sample.oneOf.0.items.[INDEX].mention_variants.oneOf.0","typeLabel":"string[]"},{"items":{"type":"string"},"type":"null","uniqueKey":"sample.oneOf.0.items.[INDEX].mention_variants.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample.oneOf.0.items.[INDEX].mention_variants","typeLabel":"string[] | null"},"relevance":{"description":"How this match relates to the watched entity, classified by the summarizer: on_target (the entity is the mention's subject or a substantive reference) or incidental (a correct but passing reference in service of another story). Absent when unjudged. Lets a client tell a substantive mention from a fly-by one. (A third internal verdict, wrong_entity, marks knowledge-graph name collisions; those matches are suppressed before delivery and never appear here.)","enum":["on_target","incidental"],"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].relevance","typeLabel":"enum\u003cstring>"},"roles":{"oneOf":[{"description":"Canonical speaker role(s) the matched entity appeared as, drawn from the alert's speaker roles: by default GUEST, PANELIST, CORRESPONDENT, AUDIENCE, or SOUNDBITE_SPEAKER (an excerpted clip of them, not a live appearance), and HOST only when speaker_roles includes it. Raw STT/LLM labels like CALLER, REPORTER, LISTENER are normalized to these buckets on write. Populated only for PODCAST_SPEAKER matches; sorted alphabetically for deterministic order.","items":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].roles.oneOf.0.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"sample.oneOf.0.items.[INDEX].roles.oneOf.0","typeLabel":"string[]"},{"description":"Canonical speaker role(s) the matched entity appeared as, drawn from the alert's speaker roles: by default GUEST, PANELIST, CORRESPONDENT, AUDIENCE, or SOUNDBITE_SPEAKER (an excerpted clip of them, not a live appearance), and HOST only when speaker_roles includes it. Raw STT/LLM labels like CALLER, REPORTER, LISTENER are normalized to these buckets on write. Populated only for PODCAST_SPEAKER matches; sorted alphabetically for deterministic order.","items":{"type":"string"},"type":"null","uniqueKey":"sample.oneOf.0.items.[INDEX].roles.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample.oneOf.0.items.[INDEX].roles","typeLabel":"string[] | null"},"truncated":{"type":"boolean","uniqueKey":"sample.oneOf.0.items.[INDEX].truncated","typeLabel":"boolean"},"windows":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].end_seconds","typeLabel":"number\u003cdouble>"},"lines":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].end_seconds","typeLabel":"number\u003cdouble>"},"start_seconds":{"format":"double","type":"number","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].start_seconds","typeLabel":"number\u003cdouble>"},"text":{"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].text","typeLabel":"string"},"is_mention":{"type":"boolean","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].is_mention","typeLabel":"boolean"},"number":{"format":"int64","type":"integer","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].number","typeLabel":"integer\u003cint64>"},"role":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].role","typeLabel":"string"},"speaker":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker","typeLabel":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker_statement_characteristics.certainty","typeLabel":"enum\u003cstring>"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker_statement_characteristics.sentiment","typeLabel":"enum\u003cstring>"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker_statement_characteristics.specificity","typeLabel":"enum\u003cstring>"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker_statement_characteristics.temporal_orientation","typeLabel":"enum\u003cstring>"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled.","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX].speaker_statement_characteristics","typeLabel":"object"}},"required":["start_seconds","end_seconds","text"],"type":"object","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].lines","typeLabel":"object[] | null"},"start_seconds":{"format":"double","type":"number","isRequired":true,"uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].start_seconds","typeLabel":"number\u003cdouble>"},"clip_description":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].clip_description","typeLabel":"string"},"clip_id":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].clip_id","typeLabel":"string"},"clip_intro_statement":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].clip_intro_statement","typeLabel":"string"},"clip_title":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].clip_title","typeLabel":"string"},"clip_type":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].clip_type","typeLabel":"string"},"segment_description":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].segment_description","typeLabel":"string"},"segment_id":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].segment_id","typeLabel":"string"},"segment_summary":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].segment_summary","typeLabel":"string"},"segment_title":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].segment_title","typeLabel":"string"},"segment_type":{"type":"string","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX].segment_type","typeLabel":"string"}},"required":["start_seconds","end_seconds","lines"],"type":"object","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.0","typeLabel":"object[]"},{"items":{"additionalProperties":false,"properties":{"clip_description":{"type":"string"},"clip_id":{"type":"string"},"clip_intro_statement":{"type":"string"},"clip_title":{"type":"string"},"clip_type":{"type":"string"},"end_seconds":{"format":"double","type":"number"},"lines":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"array"},{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"null"}]},"segment_description":{"type":"string"},"segment_id":{"type":"string"},"segment_summary":{"type":"string"},"segment_title":{"type":"string"},"segment_type":{"type":"string"},"start_seconds":{"format":"double","type":"number"}},"required":["start_seconds","end_seconds","lines"],"type":"object"},"type":"null","uniqueKey":"sample.oneOf.0.items.[INDEX].windows.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample.oneOf.0.items.[INDEX].windows","typeLabel":"object[] | null"}},"required":["id","monitor_id","alert_id","kind","entity_type","entity_id","source_type","source_id","detected_at","mention_count","deliveries"],"type":"object","uniqueKey":"sample.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"sample.oneOf.0","typeLabel":"object[]"},{"description":"Up to AlertPreviewSampleSize most-recent matches with payload fully hydrated. Empty until status is completed.","items":{"additionalProperties":false,"properties":{"alert_id":{"description":"ID of the parent alert.","type":"string"},"deliveries":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"error_message":{"type":"string"},"id":{"type":"string"},"sent_at":{"format":"date-time","type":"string"},"status":{"description":"Delivery outcome — SENT (delivered; a partial success keeps this status with the failure noted in error_message), FAILED (an attempt failed; realtime retries within its budget and digests re-select within their window), SKIPPED (intentionally not delivered), or ABANDONED (realtime webhook delivery permanently gave up after exhausting its retry budget, so the match was dropped for that channel).","type":"string"}},"required":["id","channel","status","created_at"],"type":"object"},"type":"array"},{"items":{"additionalProperties":false,"properties":{"channel":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"error_message":{"type":"string"},"id":{"type":"string"},"sent_at":{"format":"date-time","type":"string"},"status":{"description":"Delivery outcome — SENT (delivered; a partial success keeps this status with the failure noted in error_message), FAILED (an attempt failed; realtime retries within its budget and digests re-select within their window), SKIPPED (intentionally not delivered), or ABANDONED (realtime webhook delivery permanently gave up after exhausting its retry budget, so the match was dropped for that channel).","type":"string"}},"required":["id","channel","status","created_at"],"type":"object"},"type":"null"}]},"detected_at":{"format":"date-time","type":"string"},"entity_id":{"type":"string"},"entity_type":{"description":"Type of the watched target: PERSON, COMPANY, or KNOWLEDGE_GRAPH_ENTITY for entity alerts, KEYWORD for KEYWORD_MENTION alerts.","type":"string"},"episode":{"additionalProperties":false,"properties":{"apple_podcasts_url":{"description":"Apple Podcasts deep-link for the parent podcast. Omitted when the podcast has no iTunes ID.","type":"string"},"audio_url":{"description":"CDN-fronted URL for the full episode audio, playable directly in a browser \u003caudio> element without auth (the podcast's own public media). Clients play a specific window by loading this and seeking to the window's start_seconds. Omitted when the episode has no stored audio yet. Present on both the member and public landing-page tiers so a shared link can play the clip.","type":"string"},"duration_seconds":{"description":"Total episode duration in seconds. Omitted when unknown.","format":"double","type":"number"},"explicit":{"description":"Whether the episode is flagged as containing explicit content by its publisher.","type":"boolean"},"image_url":{"description":"Episode-specific image. Omitted when the episode has no dedicated image. Clients should fall back to podcast_image_url for a card thumbnail in that case.","type":"string"},"podcast_bias":{"description":"Political bias rating for the parent podcast. Omitted when the podcast is not substantively political or has not been evaluated yet. Fetch GET /v1/podcasts/{id}/bias for the full analysis including reasoning and evidence.","enum":["EXTREME_LEFT","LEANS_LEFT","LEFT","CENTER","RIGHT","LEANS_RIGHT","EXTREME_RIGHT"],"type":"string"},"podcast_id":{"type":"string"},"podcast_image_url":{"description":"Parent podcast's image. Suitable as a fallback when image_url is absent.","type":"string"},"podcast_popularity":{"description":"Parent podcast's global popularity percentile in (0,1] — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts charts). Higher is more popular; 1.0 is the most popular show. Omitted when the podcast is not currently charting.","format":"double","type":"number"},"podcast_popularity_badge":{"description":"Human-facing reach tier derived from podcast_popularity: Top Podcast (top 1%), Very Popular (top 5%), or Popular (top 10%). Omitted for shows outside the top 10%.","enum":["Top Podcast","Very Popular","Popular"],"type":"string"},"podcast_slug":{"type":"string"},"podcast_title":{"type":"string"},"published_at":{"format":"date-time","type":"string"},"slug":{"type":"string"},"title":{"type":"string"}},"required":["title","podcast_id","podcast_title"],"type":"object","description":"Optional episode + podcast metadata embedded so a single response renders a card without a follow-up /v1/episodes/{id} call. Populated for preview-sample matches (POST /v1/projects/{projectId}/alerts/preview's GET response) and for the landing-page GETs (GET /v1/alerts/deliveries/{id} in both summary and detailed views, GET /v1/alerts/matches/{id}); absent on the paginated live matches list."},"id":{"type":"string"},"is_backfilled":{"description":"True for matches written by the post-create historical sweep. Backfilled matches are real matches the live pipeline would have produced, with DetectedAt set to the source episode's publish time. They never trigger delivery (no email is sent) — the field lets the UI label them so users can distinguish 'past' from 'going-forward' matches.","type":"boolean"},"keyword":{"description":"KEYWORD_MENTION matches only: the phrase this match fired on. It stays the phrase that matched even if the alert's keyword is later edited.","type":"string"},"kind":{"description":"Inherited from the parent alert's kind so clients can render mention vs appearance semantics without a follow-up alert lookup. Match payloads from ENTITY_MENTION and KEYWORD_MENTION alerts carry mention_count and mention_variants; PODCAST_SPEAKER matches carry roles and a line-count in mention_count.","enum":["ENTITY_MENTION","PODCAST_SPEAKER","KEYWORD_MENTION"],"type":"string"},"llm_summary":{"description":"AI-generated narrative summary of this match with prior-mention context from the past 7 days for the same (alert, entity). Generated asynchronously after match creation. Absent (field omitted) when the summarizer hasn't processed the row yet OR when the LLM exhausted its retry budget — clients should treat both states the same: no summary to render. Visible to both org members and the public landing-page tier; the summary describes the mention itself, not the alert configuration.","type":"string"},"mention_count":{"format":"int64","type":"integer"},"mention_variants":{"oneOf":[{"items":{"type":"string"},"type":"array"},{"items":{"type":"string"},"type":"null"}]},"monitor_id":{"description":"Deprecated — use alert_id. ID of the parent alert.","type":"string"},"relevance":{"description":"How this match relates to the watched entity, classified by the summarizer: on_target (the entity is the mention's subject or a substantive reference) or incidental (a correct but passing reference in service of another story). Absent when unjudged. Lets a client tell a substantive mention from a fly-by one. (A third internal verdict, wrong_entity, marks knowledge-graph name collisions; those matches are suppressed before delivery and never appear here.)","enum":["on_target","incidental"],"type":"string"},"roles":{"oneOf":[{"description":"Canonical speaker role(s) the matched entity appeared as, drawn from the alert's speaker roles: by default GUEST, PANELIST, CORRESPONDENT, AUDIENCE, or SOUNDBITE_SPEAKER (an excerpted clip of them, not a live appearance), and HOST only when speaker_roles includes it. Raw STT/LLM labels like CALLER, REPORTER, LISTENER are normalized to these buckets on write. Populated only for PODCAST_SPEAKER matches; sorted alphabetically for deterministic order.","items":{"type":"string"},"type":"array"},{"description":"Canonical speaker role(s) the matched entity appeared as, drawn from the alert's speaker roles: by default GUEST, PANELIST, CORRESPONDENT, AUDIENCE, or SOUNDBITE_SPEAKER (an excerpted clip of them, not a live appearance), and HOST only when speaker_roles includes it. Raw STT/LLM labels like CALLER, REPORTER, LISTENER are normalized to these buckets on write. Populated only for PODCAST_SPEAKER matches; sorted alphabetically for deterministic order.","items":{"type":"string"},"type":"null"}]},"source_id":{"type":"string"},"source_type":{"type":"string"},"truncated":{"type":"boolean"},"windows":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"clip_description":{"type":"string"},"clip_id":{"type":"string"},"clip_intro_statement":{"type":"string"},"clip_title":{"type":"string"},"clip_type":{"type":"string"},"end_seconds":{"format":"double","type":"number"},"lines":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"array"},{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"null"}]},"segment_description":{"type":"string"},"segment_id":{"type":"string"},"segment_summary":{"type":"string"},"segment_title":{"type":"string"},"segment_type":{"type":"string"},"start_seconds":{"format":"double","type":"number"}},"required":["start_seconds","end_seconds","lines"],"type":"object"},"type":"array"},{"items":{"additionalProperties":false,"properties":{"clip_description":{"type":"string"},"clip_id":{"type":"string"},"clip_intro_statement":{"type":"string"},"clip_title":{"type":"string"},"clip_type":{"type":"string"},"end_seconds":{"format":"double","type":"number"},"lines":{"oneOf":[{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"array"},{"items":{"additionalProperties":false,"properties":{"end_seconds":{"format":"double","type":"number"},"is_mention":{"type":"boolean"},"number":{"format":"int64","type":"integer"},"role":{"type":"string"},"speaker":{"type":"string"},"speaker_statement_characteristics":{"additionalProperties":false,"properties":{"certainty":{"description":"How sure the speaker sounds: hedged (\"maybe\", \"I think\", \"it could\"), neutral, or confident (flat assertion).","enum":["hedged","neutral","confident"],"type":"string"},"sentiment":{"description":"The statement's tone: negative, neutral or positive.","enum":["negative","neutral","positive"],"type":"string"},"specificity":{"description":"Whether the line commits to something concrete: specific (names, numbers, dates, mechanisms), neutral, or vague (generalities).","enum":["vague","neutral","specific"],"type":"string"},"temporal_orientation":{"description":"Where the line points in time: past (looking back), present (how things are), or future (predictions, plans, expectations).","enum":["past","present","future"],"type":"string"}},"required":["sentiment","certainty","specificity","temporal_orientation"],"type":"object","description":"How the line was said, one label per axis; absent for a line outside topic and interview segments, too short to read, or on a match detected before lines were labelled."},"start_seconds":{"format":"double","type":"number"},"text":{"type":"string"}},"required":["start_seconds","end_seconds","text"],"type":"object"},"type":"null"}]},"segment_description":{"type":"string"},"segment_id":{"type":"string"},"segment_summary":{"type":"string"},"segment_title":{"type":"string"},"segment_type":{"type":"string"},"start_seconds":{"format":"double","type":"number"}},"required":["start_seconds","end_seconds","lines"],"type":"object"},"type":"null"}]}},"required":["id","monitor_id","alert_id","kind","entity_type","entity_id","source_type","source_id","detected_at","mention_count","deliveries"],"type":"object"},"type":"null","uniqueKey":"sample.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample","typeLabel":"object[] | null"}},"required":["status","window_days","started_at","total_matches"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"started_at":"2023-11-07T05:31:56Z","status":"in_progress","total_matches":123,"window_days":123,"by_day":[{"count":123,"date":"\u003cstring>"}],"completed_at":"2023-11-07T05:31:56Z","error":"\u003cstring>","sample":[{"alert_id":"\u003cstring>","deliveries":[{"channel":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","id":"\u003cstring>","status":"\u003cstring>","error_message":"\u003cstring>","sent_at":"2023-11-07T05:31:56Z"}],"detected_at":"2023-11-07T05:31:56Z","entity_id":"\u003cstring>","entity_type":"\u003cstring>","id":"\u003cstring>","kind":"ENTITY_MENTION","mention_count":123,"monitor_id":"\u003cstring>","source_id":"\u003cstring>","source_type":"\u003cstring>","episode":{"podcast_id":"\u003cstring>","podcast_title":"\u003cstring>","title":"\u003cstring>","apple_podcasts_url":"\u003cstring>","audio_url":"\u003cstring>","duration_seconds":123,"explicit":true,"image_url":"\u003cstring>","podcast_bias":"EXTREME_LEFT","podcast_image_url":"\u003cstring>","podcast_popularity":123,"podcast_popularity_badge":"Top Podcast","podcast_slug":"\u003cstring>","published_at":"2023-11-07T05:31:56Z","slug":"\u003cstring>"},"is_backfilled":true,"keyword":"\u003cstring>","llm_summary":"\u003cstring>","mention_variants":["\u003cstring>"],"relevance":"on_target","roles":["\u003cstring>"],"truncated":true,"windows":[{"end_seconds":123,"lines":[{"end_seconds":123,"start_seconds":123,"text":"\u003cstring>","is_mention":true,"number":123,"role":"\u003cstring>","speaker":"\u003cstring>","speaker_statement_characteristics":{"certainty":"hedged","sentiment":"negative","specificity":"vague","temporal_orientation":"past"}}],"start_seconds":123,"clip_description":"\u003cstring>","clip_id":"\u003cstring>","clip_intro_statement":"\u003cstring>","clip_title":"\u003cstring>","clip_type":"\u003cstring>","segment_description":"\u003cstring>","segment_id":"\u003cstring>","segment_summary":"\u003cstring>","segment_title":"\u003cstring>","segment_type":"\u003cstring>"}]}]}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"8185d3b5-9e66-4464-8db8-0e0a91c449cf":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"error_code":{"type":"string","uniqueKey":"error_code","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"resolve":{"additionalProperties":false,"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"resolve.message","typeLabel":"string"},"action":{"type":"string","uniqueKey":"resolve.action","typeLabel":"string"},"endpoint":{"type":"string","uniqueKey":"resolve.endpoint","typeLabel":"string"},"method":{"type":"string","uniqueKey":"resolve.method","typeLabel":"string"},"url":{"type":"string","uniqueKey":"resolve.url","typeLabel":"string"}},"required":["message"],"type":"object","uniqueKey":"resolve","typeLabel":"object"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","error_code":"\u003cstring>","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","resolve":{"message":"\u003cstring>","action":"\u003cstring>","endpoint":"\u003cstring>","method":"\u003cstring>","url":"\u003cstring>"},"status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"a5428769-866c-42c7-a004-c213d9b7ee43":{"ApiKeyHeader":{"description":"Pass your API key in the X-API-Key header (recommended).","in":"header","name":"X-API-Key","type":"apiKey","scopes":[],"schemeName":"ApiKeyHeader"}},"0ced4d8f-1c3f-4d2a-8de5-c63f277c6d53":{"BearerAuth":{"description":"Pass your API key as a Bearer token in the Authorization header.","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"bc7c60ad-8b90-43eb-b968-32aa4dec56b4":{"url":"https://api.particle.pro"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Pass your API key in the X-API-Key header (recommended).","in":"header","name":"X-API-Key","type":"apiKey","scopes":[],"schemeName":"ApiKeyHeader"},"schema":{"title":"X-API-Key","type":"string","description":"Pass your API key in the X-API-Key header (recommended).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyHeader","name":"X-API-Key"}],"title":"ApiKeyHeader"},{"schemes":[{"scheme":{"description":"Pass your API key as a Bearer token in the Authorization header.","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Pass your API key as a Bearer token in the Authorization header.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"particle-c40da4e2","siteName":"Particle API","title":"Get the status and result of an alert preview - Particle API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T20:55:41.344Z","originalFileLocation":"api-reference/alerts/get-the-status-and-result-of-an-alert-preview.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Particle API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get the status and result of an alert preview - Particle API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Particle API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://particle-c40da4e2.mintlify.app/_mintlify/api/og/v2?division=Alerts\u0026amp;title=Get+the+status+and+result+of+an+alert+preview\u0026amp;description=Returns+the+current+state+of+an+async+preview+sweep.+Status+transitions+in_progress+%E2%86%92+completed+%28or+failed%29.+Previews+are+retained+for+1+hour%3B+expired+IDs+retur\u0026amp;theme=cc76b59effb7ea31e0037892\u0026amp;signature=c359a66eb18ce47e00d8431676bab9f4c31311f76a70180b28734933083af45a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get the status and result of an alert preview - Particle API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://particle-c40da4e2.mintlify.app/_mintlify/api/og/v2?division=Alerts\u0026amp;title=Get+the+status+and+result+of+an+alert+preview\u0026amp;description=Returns+the+current+state+of+an+async+preview+sweep.+Status+transitions+in_progress+%E2%86%92+completed+%28or+failed%29.+Previews+are+retained+for+1+hour%3B+expired+IDs+retur\u0026amp;theme=cc76b59effb7ea31e0037892\u0026amp;signature=c359a66eb18ce47e00d8431676bab9f4c31311f76a70180b28734933083af45a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/particle-c40da4e2/Uccj8-qi0DrvBDRY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Particle API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0369a1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/alerts/get-the-status-and-result-of-an-alert-preview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.particle.pro/#organization\",\"name\":\"Particle API\",\"url\":\"https://docs.particle.pro\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/particle-c40da4e2/tk5mmLn_iJIxNhbI/logo/light.svg?fit=max\u0026auto=format\u0026n=tk5mmLn_iJIxNhbI\u0026q=85\u0026s=a659784e597694177292b154cc1808f4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.particle.pro#website\",\"name\":\"Particle API\",\"url\":\"https://docs.particle.pro\",\"publisher\":{\"@id\":\"https://docs.particle.pro/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview#webpage\",\"url\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview\",\"name\":\"Get the status and result of an alert preview\",\"description\":\"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\",\"dateModified\":\"2026-10-30T20:55:41.344Z\",\"isPartOf\":{\"@id\":\"https://docs.particle.pro#website\"},\"breadcrumb\":{\"@id\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Alerts\",\"item\":\"https://docs.particle.pro/api-reference/alerts/get-a-single-alert-delivery\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get the status and result of an alert preview\",\"item\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview#apireference\",\"headline\":\"Get the status and result of an alert preview\",\"name\":\"Get the status and result of an alert preview\",\"description\":\"Returns the current state of an async preview sweep. Status transitions in_progress → completed (or failed). Previews are retained for 1 hour; expired IDs return 404.\",\"url\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.particle.pro/api-reference/alerts/get-the-status-and-result-of-an-alert-preview#webpage\"},\"dateModified\":\"2026-10-30T20:55:41.344Z\",\"publisher\":{\"@id\":\"https://docs.particle.pro/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.particle.pro#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Particle API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Particle API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Alerts","sidebarTitle":"Alerts overview","icon":"bell","href":"/api-reference/alerts"}]},{"group":"Alerts","pages":[{"title":"Get a single alert delivery","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/deliveries/{id}","href":"/api-reference/alerts/get-a-single-alert-delivery"},{"title":"Get the exact JSON a webhook delivery POSTed","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/deliveries/{id}/webhook-payload","href":"/api-reference/alerts/get-the-exact-json-a-webhook-delivery-posted"},{"title":"Preview alert disable action","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/disable","href":"/api-reference/alerts/preview-alert-disable-action"},{"title":"Disable an alert via email-footer token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/alerts/disable","href":"/api-reference/alerts/disable-an-alert-via-email-footer-token"},{"title":"Get a single alert match","description":"Returns one match with full hydration — transcript Windows, source-episode metadata, and the deliveries that included this match. The URL is keyed only by the match ID so a result link can be shared publicly without leaking the alert identifier. Use this for per-match landing pages opened from a digest or results list. URL possession is the access factor; authenticated org members see the full payload while unauthenticated and non-member callers see a reduced public payload (entity + episode, no transcript dialogue). Single-match only: digests (daily/weekly) embed many matches and should be fetched via GET /v1/alerts/deliveries/{id}?view=detailed.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/matches/{id}","href":"/api-reference/alerts/get-a-single-alert-match"},{"title":"Get the status and result of an alert preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/preview/{previewId}","href":"/api-reference/alerts/get-the-status-and-result-of-an-alert-preview"},{"title":"Get an alert","description":"Returns a single alert by ID.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/{id}","href":"/api-reference/alerts/get-an-alert"},{"title":"Delete an alert","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/alerts/{id}","href":"/api-reference/alerts/delete-an-alert"},{"title":"Update an alert","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/alerts/{id}","href":"/api-reference/alerts/update-an-alert"},{"title":"List deliveries for an alert","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/{id}/deliveries","href":"/api-reference/alerts/list-deliveries-for-an-alert"},{"title":"List matches for an alert","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/alerts/{id}/matches","href":"/api-reference/alerts/list-matches-for-an-alert"},{"title":"Send a test webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/alerts/{id}/test-webhook","href":"/api-reference/alerts/send-a-test-webhook"},{"title":"List alerts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/projects/{projectId}/alerts","href":"/api-reference/alerts/list-alerts"},{"title":"Create an alert","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/projects/{projectId}/alerts","href":"/api-reference/alerts/create-an-alert"},{"title":"Preview match frequency for an alert before creating it","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/projects/{projectId}/alerts/preview","href":"/api-reference/alerts/preview-match-frequency-for-an-alert-before-creating-it"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies","href":"/api-reference/companies/list-companies"},{"title":"Get a company","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}","href":"/api-reference/companies/get-a-company"},{"title":"List company competitors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/competitors","href":"/api-reference/companies/list-company-competitors"},{"title":"List a company's external profiles","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/external-links","href":"/api-reference/companies/list-a-companys-external-profiles"},{"title":"List company people","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/people","href":"/api-reference/companies/list-company-people"},{"title":"Get company advertising profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/podcast/advertising","href":"/api-reference/companies/get-company-advertising-profile"},{"title":"List company podcast advertising placements","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/podcast/advertising/placements","href":"/api-reference/companies/list-company-podcast-advertising-placements"},{"title":"List podcasts carrying company advertising","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/podcast/advertising/podcasts","href":"/api-reference/companies/list-podcasts-carrying-company-advertising"},{"title":"List podcasts a company could advertise on next","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/podcast/recommendations","href":"/api-reference/companies/list-podcasts-a-company-could-advertise-on-next"},{"title":"List company products","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/products","href":"/api-reference/companies/list-company-products"},{"title":"Get how a company's people speak","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/companies/{id}/statement-characteristics","href":"/api-reference/companies/get-how-a-companys-people-speak"}]},{"group":"Embed","pages":[{"title":"Get clip embed","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/embed/clips/{id}","href":"/api-reference/embed/get-clip-embed"},{"title":"Get clip embed transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/embed/clips/{id}/transcript","href":"/api-reference/embed/get-clip-embed-transcript"},{"title":"Get episode embed code","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/embed/episodes/{episode_id}/code","href":"/api-reference/embed/get-episode-embed-code"}]},{"group":"Entities","pages":[{"title":"List entities","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entities","href":"/api-reference/entities/list-entities"},{"title":"Look up people and companies by external identifier","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entities/lookup","href":"/api-reference/entities/look-up-people-and-companies-by-external-identifier"},{"title":"Search entities","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entities/search","href":"/api-reference/entities/search-entities"},{"title":"List entity types","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entities/types","href":"/api-reference/entities/list-entity-types"},{"title":"Get an entity","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/entities/{id}","href":"/api-reference/entities/get-an-entity"}]},{"group":"Account","pages":[{"title":"Identify your API key","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me","href":"/api-reference/account/identify-your-api-key"},{"title":"Get your API key's usage","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me/usage","href":"/api-reference/account/get-your-api-keys-usage"}]},{"group":"People","pages":[{"title":"Find experts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/expertise","href":"/api-reference/people/find-experts"},{"title":"List fields of research","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/fields","href":"/api-reference/people/list-fields-of-research"},{"title":"Get a field of research","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/fields/{code}","href":"/api-reference/people/get-a-field-of-research"},{"title":"Rank a field of research's guests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/fields/{code}/guests","href":"/api-reference/people/rank-a-field-of-researchs-guests"},{"title":"Rank the podcasts that book a field of research","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/fields/{code}/podcasts","href":"/api-reference/people/rank-the-podcasts-that-book-a-field-of-research"},{"title":"List occupations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/occupations","href":"/api-reference/people/list-occupations"},{"title":"Get an occupation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/occupations/{code}","href":"/api-reference/people/get-an-occupation"},{"title":"Rank an occupation's guests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/occupations/{code}/guests","href":"/api-reference/people/rank-an-occupations-guests"},{"title":"Rank the podcasts that book an occupation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/occupations/{code}/podcasts","href":"/api-reference/people/rank-the-podcasts-that-book-an-occupation"},{"title":"Get a Person","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/{id}","href":"/api-reference/people/get-a-person"},{"title":"Get a Person's expertise","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/{id}/expertise","href":"/api-reference/people/get-a-persons-expertise"},{"title":"Get how a Person speaks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/{id}/statement-characteristics","href":"/api-reference/people/get-how-a-person-speaks"},{"title":"List a Person's external profiles","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/people/{slug}/external-links","href":"/api-reference/people/list-a-persons-external-profiles"}]},{"group":"Podcasts","pages":[{"title":"List and search podcasts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts","href":"/api-reference/podcasts/list-and-search-podcasts"},{"title":"Download the show archive","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/archive/download","href":"/api-reference/podcasts/download-the-show-archive"},{"title":"Look up podcasts by external platform identifier","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/lookup","href":"/api-reference/podcasts/look-up-podcasts-by-external-platform-identifier"},{"title":"Search podcasts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/search","href":"/api-reference/podcasts/search-podcasts"},{"title":"Get podcast catalog statistics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/stats","href":"/api-reference/podcasts/get-podcast-catalog-statistics"},{"title":"List podcast topics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/topics","href":"/api-reference/podcasts/list-podcast-topics"},{"title":"Get a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}","href":"/api-reference/podcasts/get-a-podcast"},{"title":"Get podcast advertising profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/advertising","href":"/api-reference/podcasts/get-podcast-advertising-profile"},{"title":"Get a podcast's latest bias analysis","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/bias","href":"/api-reference/podcasts/get-a-podcasts-latest-bias-analysis"},{"title":"List episodes for a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/episodes","href":"/api-reference/podcasts/list-episodes-for-a-podcast"},{"title":"List a podcast's third-party platform presences","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/external-links","href":"/api-reference/podcasts/list-a-podcasts-third-party-platform-presences"},{"title":"Get a podcast's format profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/format","href":"/api-reference/podcasts/get-a-podcasts-format-profile"},{"title":"List entity mentions in a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/mentions","href":"/api-reference/podcasts/list-entity-mentions-in-a-podcast"},{"title":"List sponsors a podcast could pitch","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/recommendations/sponsors","href":"/api-reference/podcasts/list-sponsors-a-podcast-could-pitch"},{"title":"List related podcasts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/related","href":"/api-reference/podcasts/list-related-podcasts"},{"title":"Get a podcast's latest brand suitability assessment","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/suitability","href":"/api-reference/podcasts/get-a-podcasts-latest-brand-suitability-assessment"}]},{"group":"Podcast Advertising","pages":[{"title":"Get sponsor co-occurrence","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/co-occurrence","href":"/api-reference/podcast-advertising/get-sponsor-co-occurrence"},{"title":"Get advertising leaderboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/leaderboard","href":"/api-reference/podcast-advertising/get-advertising-leaderboard"},{"title":"Get advertising leaderboard preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/leaderboard/preview","href":"/api-reference/podcast-advertising/get-advertising-leaderboard-preview"},{"title":"Get publisher advertising leaderboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/publishers/leaderboard","href":"/api-reference/podcast-advertising/get-publisher-advertising-leaderboard"},{"title":"List sponsors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors","href":"/api-reference/podcast-advertising/list-sponsors"},{"title":"List trending sponsors","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors/trends","href":"/api-reference/podcast-advertising/list-trending-sponsors"},{"title":"Get a sponsor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors/{id}","href":"/api-reference/podcast-advertising/get-a-sponsor"},{"title":"List podcasts for a sponsor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors/{id}/podcasts","href":"/api-reference/podcast-advertising/list-podcasts-for-a-sponsor"},{"title":"List publishers for a sponsor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors/{id}/publishers","href":"/api-reference/podcast-advertising/list-publishers-for-a-sponsor"},{"title":"List ad segments for a sponsor","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/sponsors/{id}/segments","href":"/api-reference/podcast-advertising/list-ad-segments-for-a-sponsor"},{"title":"Get advertising timeseries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/advertising/timeseries","href":"/api-reference/podcast-advertising/get-advertising-timeseries"},{"title":"Get publisher advertising profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/advertising","href":"/api-reference/podcast-advertising/get-publisher-advertising-profile"},{"title":"List publisher's podcasts ranked by ad volume","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/advertising/podcasts","href":"/api-reference/podcast-advertising/list-publishers-podcasts-ranked-by-ad-volume"},{"title":"List sponsors for a publisher","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/advertising/sponsors","href":"/api-reference/podcast-advertising/list-sponsors-for-a-publisher"},{"title":"List sponsors advertising on a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/advertising/sponsors","href":"/api-reference/podcast-advertising/list-sponsors-advertising-on-a-podcast"}]},{"group":"Podcast Bias","pages":[{"title":"Rank publishers by political bias metric","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/bias/publishers/leaderboard","href":"/api-reference/podcast-bias/rank-publishers-by-political-bias-metric"},{"title":"List publishers with podcasts in a bias bucket","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/bias/{result}/publishers","href":"/api-reference/podcast-bias/list-publishers-with-podcasts-in-a-bias-bucket"},{"title":"Get publisher political bias profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/bias","href":"/api-reference/podcast-bias/get-publisher-political-bias-profile"},{"title":"List analyzed podcasts for a publisher","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/bias/podcasts","href":"/api-reference/podcast-bias/list-analyzed-podcasts-for-a-publisher"}]},{"group":"Podcast Clips","pages":[{"title":"List clips","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/clips","href":"/api-reference/podcast-clips/list-clips"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/clips/{id}","href":"/api-reference/podcast-clips/get-a-clip"},{"title":"List clips for an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/clips","href":"/api-reference/podcast-clips/list-clips-for-an-episode"}]},{"group":"Podcast Transcripts","pages":[{"title":"Get clip transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/clips/{id}/transcript","href":"/api-reference/podcast-transcripts/get-clip-transcript"},{"title":"Get episode transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/transcript","href":"/api-reference/podcast-transcripts/get-episode-transcript"},{"title":"Get entity mentions in transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/transcript/mentions","href":"/api-reference/podcast-transcripts/get-entity-mentions-in-transcript"},{"title":"Get a transcript excerpt around a moment","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/transcript/preview","href":"/api-reference/podcast-transcripts/get-a-transcript-excerpt-around-a-moment"},{"title":"Get word-level transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/transcript/words","href":"/api-reference/podcast-transcripts/get-word-level-transcript"},{"title":"Get segment transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/segments/{id}/transcript","href":"/api-reference/podcast-transcripts/get-segment-transcript"}]},{"group":"Entity Charts","pages":[{"title":"List entity charts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/entities/charts","href":"/api-reference/entity-charts/list-entity-charts"},{"title":"Get an entity chart","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/entities/charts/{category}","href":"/api-reference/entity-charts/get-an-entity-chart"}]},{"group":"Podcast Episodes","pages":[{"title":"List episodes","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes","href":"/api-reference/podcast-episodes/list-episodes"},{"title":"List the episode archive","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/archive","href":"/api-reference/podcast-episodes/list-the-episode-archive"},{"title":"Download the episode archive","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/archive/download","href":"/api-reference/podcast-episodes/download-the-episode-archive"},{"title":"Replay the episode archive","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/archive/stream","href":"/api-reference/podcast-episodes/replay-the-episode-archive"},{"title":"Poll the episode feed","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/feed","href":"/api-reference/podcast-episodes/poll-the-episode-feed"},{"title":"Look up episodes by external identifier","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/lookup","href":"/api-reference/podcast-episodes/look-up-episodes-by-external-identifier"},{"title":"Stream episodes","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/stream","href":"/api-reference/podcast-episodes/stream-episodes"},{"title":"Stream episodes (POST)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/podcasts/episodes/stream","href":"/api-reference/podcast-episodes/stream-episodes-post"},{"title":"Get episode timeseries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/timeseries","href":"/api-reference/podcast-episodes/get-episode-timeseries"},{"title":"Get an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}","href":"/api-reference/podcast-episodes/get-an-episode"},{"title":"List ads in an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/ads","href":"/api-reference/podcast-episodes/list-ads-in-an-episode"},{"title":"List entities in an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/entities","href":"/api-reference/podcast-episodes/list-entities-in-an-episode"},{"title":"List an episode's guest expertise","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/expertise","href":"/api-reference/podcast-episodes/list-an-episodes-guest-expertise"},{"title":"List related episodes","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/related","href":"/api-reference/podcast-episodes/list-related-episodes"},{"title":"List speakers in an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/speakers","href":"/api-reference/podcast-episodes/list-speakers-in-an-episode"},{"title":"List topics for an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/topics","href":"/api-reference/podcast-episodes/list-topics-for-an-episode"}]},{"group":"Podcast Episode Search","pages":[{"title":"Search podcast episode content","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/search","href":"/api-reference/podcast-episode-search/search-podcast-episode-content"},{"title":"Search podcast dialogue for entity mentions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/mentions","href":"/api-reference/podcast-episode-search/search-podcast-dialogue-for-entity-mentions"},{"title":"List an entity's mentions by podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/mentions/by-podcast","href":"/api-reference/podcast-episode-search/list-an-entitys-mentions-by-podcast"},{"title":"Get mention share of voice","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/mentions/share-of-voice","href":"/api-reference/podcast-episode-search/get-mention-share-of-voice"},{"title":"Compare how subjects are spoken of","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/mentions/share-of-voice/compare","href":"/api-reference/podcast-episode-search/compare-how-subjects-are-spoken-of"},{"title":"Get mention timeseries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/mentions/timeseries","href":"/api-reference/podcast-episode-search/get-mention-timeseries"}]},{"group":"Podcast Segments","pages":[{"title":"List segments for an episode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/episodes/{id}/segments","href":"/api-reference/podcast-segments/list-segments-for-an-episode"},{"title":"List segments","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/segments","href":"/api-reference/podcast-segments/list-segments"},{"title":"Get a segment","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/segments/{id}","href":"/api-reference/podcast-segments/get-a-segment"}]},{"group":"Podcast Guests","pages":[{"title":"List podcast guests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests","href":"/api-reference/podcast-guests/list-podcast-guests"},{"title":"List trending podcast guests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/trends","href":"/api-reference/podcast-guests/list-trending-podcast-guests"},{"title":"Get a podcast guest profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/{id}","href":"/api-reference/podcast-guests/get-a-podcast-guest-profile"},{"title":"List appearances for a podcast guest","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/{id}/appearances","href":"/api-reference/podcast-guests/list-appearances-for-a-podcast-guest"},{"title":"List podcasts a guest has appeared on","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/{id}/podcasts","href":"/api-reference/podcast-guests/list-podcasts-a-guest-has-appeared-on"},{"title":"List podcasts a guest could plausibly appear on next","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/{id}/recommendations/podcasts","href":"/api-reference/podcast-guests/list-podcasts-a-guest-could-plausibly-appear-on-next"},{"title":"Get a guest's brand-suitability exposure profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/guests/{id}/suitability","href":"/api-reference/podcast-guests/get-a-guests-brand-suitability-exposure-profile"},{"title":"List the guest roster for a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/guests","href":"/api-reference/podcast-guests/list-the-guest-roster-for-a-podcast"},{"title":"Get the expertise of a podcast's guests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/guests/expertise","href":"/api-reference/podcast-guests/get-the-expertise-of-a-podcasts-guests"},{"title":"List a podcast's guests in an occupation or field","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/guests/expertise/{code}","href":"/api-reference/podcast-guests/list-a-podcasts-guests-in-an-occupation-or-field"},{"title":"List guests a podcast could plausibly book","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/recommendations/guests","href":"/api-reference/podcast-guests/list-guests-a-podcast-could-plausibly-book"}]},{"group":"Podcast Publishers","pages":[{"title":"List podcast publishers","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers","href":"/api-reference/podcast-publishers/list-podcast-publishers"},{"title":"Get a podcast publisher","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}","href":"/api-reference/podcast-publishers/get-a-podcast-publisher"},{"title":"List podcasts for a publisher","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/podcasts","href":"/api-reference/podcast-publishers/list-podcasts-for-a-publisher"},{"title":"Get a publisher's brand suitability profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/suitability","href":"/api-reference/podcast-publishers/get-a-publishers-brand-suitability-profile"},{"title":"List a publisher's podcasts with their suitability verdicts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/publishers/{id}/suitability/podcasts","href":"/api-reference/podcast-publishers/list-a-publishers-podcasts-with-their-suitability-verdicts"}]},{"group":"Podcast Rankings","pages":[{"title":"List podcast rankings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings","href":"/api-reference/podcast-rankings/list-podcast-rankings"},{"title":"List ranking categories","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings/categories","href":"/api-reference/podcast-rankings/list-ranking-categories"},{"title":"List ranking countries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings/countries","href":"/api-reference/podcast-rankings/list-ranking-countries"},{"title":"Get chart slot history","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings/history","href":"/api-reference/podcast-rankings/get-chart-slot-history"},{"title":"List ranking movers","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings/movers","href":"/api-reference/podcast-rankings/list-ranking-movers"},{"title":"List ranking sources","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/rankings/sources","href":"/api-reference/podcast-rankings/list-ranking-sources"},{"title":"List current rankings for a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/rankings","href":"/api-reference/podcast-rankings/list-current-rankings-for-a-podcast"},{"title":"Get historical rankings for a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/rankings/history","href":"/api-reference/podcast-rankings/get-historical-rankings-for-a-podcast"},{"title":"Summarize a podcast's chart presence","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/rankings/summary","href":"/api-reference/podcast-rankings/summarize-a-podcasts-chart-presence"}]},{"group":"Podcast Requests","pages":[{"title":"List podcast requests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/requests","href":"/api-reference/podcast-requests/list-podcast-requests"},{"title":"Request a podcast we don't index","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/podcasts/requests","href":"/api-reference/podcast-requests/request-a-podcast-we-dont-index"},{"title":"Get a podcast request","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/requests/{id}","href":"/api-reference/podcast-requests/get-a-podcast-request"}]},{"group":"Podcast Brand Suitability","pages":[{"title":"Get publishers ranked by exposure to a brand-safety category","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/suitability/categories/{code}/publishers","href":"/api-reference/podcast-brand-suitability/get-publishers-ranked-by-exposure-to-a-brand-safety-category"},{"title":"Get a cross-publisher suitability leaderboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/suitability/publishers/leaderboard","href":"/api-reference/podcast-brand-suitability/get-a-cross-publisher-suitability-leaderboard"}]},{"group":"Podcast Transcription","pages":[{"title":"List transcription requests","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/transcription/requests","href":"/api-reference/podcast-transcription/list-transcription-requests"},{"title":"Request an episode's transcription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/podcasts/transcription/requests","href":"/api-reference/podcast-transcription/request-an-episodes-transcription"},{"title":"Get a transcription request","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/transcription/requests/{id}","href":"/api-reference/podcast-transcription/get-a-transcription-request"}]},{"group":"Podcast Ratings","pages":[{"title":"List ratings for a podcast","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/ratings","href":"/api-reference/podcast-ratings/list-ratings-for-a-podcast"},{"title":"Summarize a podcast's ratings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/podcasts/{id}/ratings/summary","href":"/api-reference/podcast-ratings/summarize-a-podcasts-ratings"}]},{"group":"Slack Connections","pages":[{"title":"List Slack connections for a project","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/projects/{projectId}/slack/connections","href":"/api-reference/slack-connections/list-slack-connections-for-a-project"},{"title":"Initiate a Slack workspace OAuth install","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/projects/{projectId}/slack/connections/initiate","href":"/api-reference/slack-connections/initiate-a-slack-workspace-oauth-install"},{"title":"Delete a Slack connection","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/projects/{projectId}/slack/connections/{id}","href":"/api-reference/slack-connections/delete-a-slack-connection"},{"title":"List channels for a Slack connection","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/projects/{projectId}/slack/connections/{id}/channels","href":"/api-reference/slack-connections/list-channels-for-a-slack-connection"},{"title":"Complete a Slack workspace OAuth install","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/slack/connections/callback","href":"/api-reference/slack-connections/complete-a-slack-workspace-oauth-install"}]},{"group":"Webhook Connections","pages":[{"title":"List webhook connections for a project","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/projects/{projectId}/webhooks/connections","href":"/api-reference/webhook-connections/list-webhook-connections-for-a-project"},{"title":"Create a webhook connection","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/projects/{projectId}/webhooks/connections","href":"/api-reference/webhook-connections/create-a-webhook-connection"},{"title":"Get a webhook connection","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/projects/{projectId}/webhooks/connections/{id}","href":"/api-reference/webhook-connections/get-a-webhook-connection"},{"title":"Delete a webhook connection","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/projects/{projectId}/webhooks/connections/{id}","href":"/api-reference/webhook-connections/delete-a-webhook-connection"},{"title":"Rotate a webhook connection's signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/projects/{projectId}/webhooks/connections/{id}/secret/rotate","href":"/api-reference/webhook-connections/rotate-a-webhook-connections-signing-secret"}]},{"group":"Topics","pages":[{"title":"List topics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/topics","href":"/api-reference/topics/list-topics"},{"title":"Get a topic","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/topics/{id}","href":"/api-reference/topics/get-a-topic"}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/mcp/overview"}]}]},"basePath":"","title":"Get the status and result of an alert preview - Particle API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}