Alerts

Never miss when topics you care about are discussed in podcasts. Set up alerts to get notified automatically when new episodes match your search terms.

How Alerts Work

1

Create an Alert

Define a search term or phrase you want to monitor (e.g., "your company name", "industry topic")
2

We Monitor New Episodes

As new episodes are transcribed, we check them against your alert terms
3

Get Notified

Receive notifications via email or webhook when matches are found

Notification Methods

Email Notifications

Receive an email digest when new matches are found. Includes:

• Episode title and podcast name
• Relevant transcript snippets
• Direct links to the matches

Webhook Notifications

Get real-time JSON payloads for integration with your systems:

• Slack, Discord, or Teams integration
• Custom dashboards
• Automated workflows

Webhooks available on Pro plan and above

Webhook Payload Format

When a match is found, webhooks receive a JSON payload with the following structure:

json

{
  "event": "notification_match",
  "notification_id": 123,
  "search_term": "artificial intelligence",
  "episode": {
    "id": 45678,
    "title": "The Future of AI in Healthcare",
    "podcast_title": "Tech Innovators Weekly"
  },
  "matches": [
    {
      "segment_id": "seg_abc123",
      "timestamp": "00:15:32",
      "text": "The impact of artificial intelligence on healthcare...",
      "url": "https://www.audioscrape.com/episode/tech-innovators/ai-healthcare#t=932"
    },
    {
      "segment_id": "seg_def456",
      "timestamp": "00:28:45",
      "text": "When we talk about artificial intelligence ethics...",
      "url": "https://www.audioscrape.com/episode/tech-innovators/ai-healthcare#t=1725"
    }
  ],
  "match_count": 2,
  "timestamp": "2024-12-15T14:30:00Z"
}

event - Always "notification_match" for alert triggers

matches - Array of all matching segments in the episode

timestamp - ISO 8601 format when the notification was sent

Use Cases

Brand Monitoring

Track when your company, products, or executives are mentioned in podcasts

Competitive Intelligence

Monitor discussions about competitors or industry trends

Research

Stay updated on specific topics for academic or market research

PR & Communications

Get notified when your press releases or announcements get podcast coverage

Managing Alerts

From your Alerts dashboard, you can:

• Create new alerts with custom search terms
• View delivery statistics (total matches, successful deliveries)
• Edit notification destinations (email or webhook URL)
• Delete alerts you no longer need

Control notification frequency (immediate, daily, weekly) in your Email Preferences.

Troubleshooting

Not receiving notifications?

Check your email spam folder and verify your email address is correct. For webhooks, ensure your endpoint is publicly accessible and returns a 2xx status code.

Too many notifications?

Your search term may be too broad. Try using more specific terms or phrases. You can also adjust notification frequency in your Email Preferences.

Webhook not triggering?

Verify your webhook URL is correct and the server is responding. Check the delivery statistics in your alerts dashboard for error messages.

Webhook option not available?

Webhooks are only available on Pro plan and above. Upgrade your plan to access webhook notifications.

API Access

Alerts can also be managed programmatically via the Notifications API.

Set Up Your First Alert

Bookmarks