Actions77
- Account Actions
- Advanced Actions
- AI Actions
- AI Media Actions
- Analytics Actions
- Approval Actions
- Audit Log Actions
- Brand Voice Actions
- Bulk Schedule Actions
- Campaign Actions
- Connect Actions
- Content Score Actions
- Conversion Actions
- Dead Letter Actions
- Inbox Actions
- Library Actions
- Listening Actions
- Media Actions
- Meta Actions
- Post Actions
- Scheduled Post Actions
- Validation Actions
- Webhook Actions
Listening → Refresh
AI-generatedSummary
Refreshes listening data for specific keywords on selected platforms, optionally scoped to a team and providing idempotency to avoid duplicate operations.
Inputs
- Team ID — Optional team identifier to scope the refresh operation, sent as an X-Team-ID header if provided.
- Idempotency Key — Optional key to ensure idempotency of the refresh request, sent as an Idempotency-Key header if provided.
- Platforms (required) — Select one or more platforms (e.g., Twitter/X, LinkedIn, Facebook) on which to refresh listening data.
- Keyword IDs (required) — Comma-separated list of keyword IDs whose listening data should be refreshed.
Output shape
a single JSON object representing the refreshed listening data response from the API
The exact structure of the returned data depends on the SendIt API response for the listening refresh operation. This operation returns the result directly without pagination or envelope wrappers.
Examples
Example 1: Use this operation when you want to refresh the listening data cache for specific keywords on selected social media or communication platforms within a particular team context.
Specify the platforms to refresh, provide the comma-separated keyword IDs to refresh for those platforms, and optionally set a team ID and idempotency key to control request scope and duplication behavior.