sales-skills/sales-talkwalker

Talkwalker Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

Ask the user:

1. What do you need help with?

   • A) Setting up monitoring (queries, topics, alerts)
   • B) Image recognition / visual analytics
   • C) API integration or data export
   • D) Competitive benchmarking / Share of Voice
   • E) Blue Silk AI or Yeti Agent configuration
   • F) Streaming API setup
   • G) Dashboard and reporting
   • H) Something else — describe it

2. Which Talkwalker plan are you on?

   • A) Core
   • B) Analyze
   • C) Business
   • D) Not sure / evaluating

3. What's your integration goal?

   • A) Just using the UI — no integration needed
   • B) Pulling data into a BI tool or dashboard
   • C) CRM sync (Salesforce, HubSpot, etc.)
   • D) Building a custom pipeline via the API
   • E) Connecting through Zapier

If the user's request already provides most of this context, skip directly to Step 2. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end.

Step 2 — Route or answer directly

• Social listening strategy across tools → /sales-social-listening [question]
• Social media management or publishing → /sales-social-media-management [question]
• Hootsuite-specific features → /sales-social-media-management [question]
• Media relations or journalist databases → /sales-media-relations [question]
• Influencer discovery → /sales-influencer-marketing [question]
• AI visibility monitoring → /sales-ai-visibility [question]

Otherwise, answer directly from the platform reference.

Step 3 — Talkwalker platform reference

Read references/platform-guide.md for the full platform reference — capabilities, pricing, data model, API details, integration recipes, code examples.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

You no longer need the platform guide — focus on the user's specific situation.

1. Query optimization — refine Boolean queries, add NOT exclusions, test with quicksearch
2. API integration — authenticate, choose Search vs Streaming, handle pagination and credits
3. Image recognition — configure logo detection, set confidence thresholds
4. Reporting — build dashboards, export data, automate reports
5. Cost control — monitor credit usage, optimize API calls, reduce noise

If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.

• No self-serve API access. You must contact Talkwalker sales to get an API token. The demo token only works with cats, dogs, and cats AND dogs queries on blogs/forums/news. Plan for sales call delays when scoping API integrations.
• Data export restrictions are strict. Facebook/Instagram content is not exportable (aggregated-only via Histogram API). X (Twitter) exports are limited to tweet ID, author ID, and sentiment, capped at ~1.5M docs/month/account. Full news article and TV Eyes content is truncated. Many source types cannot be exported at all (LinkedIn, raw Reddit, raw TikTok, Chinese sources).
• Steep learning curve. The platform is not plug-and-play. Users consistently report needing onboarding and training before getting value. Budget time for ramp-up.
• Credit consumption adds up fast. Every API result costs 1 credit (minimum 10 per call). AI summaries cost 20 credits each. Monitor credit usage carefully and optimize hpp and query scope to avoid overages.
• Pricing is non-transparent. No public pricing — you must go through sales for a quote. Annual contracts required. Expect $9K-26K+/year depending on tier and usage.
• Hootsuite overlap. Since the acquisition, Talkwalker powers Hootsuite Listening. If you're already on Hootsuite, you may have Talkwalker capabilities built in — check before buying separately.
• Quicksearch excludes social media. The non-project Search API only returns blogs, forums, and news. Social media data requires project-scoped queries with a paid access token.

Before recommending a specific platform skill

This skill covers a strategy domain across many platforms. Before pointing the user to any specific platform skill (any /sales-{platform} listed in ## Related skills, e.g., /sales-mailshake, /sales-klaviyo, /sales-apollo), read that platform skill's actual SKILL.md first. The 1-line description in ## Related skills is enough to identify a candidate — it's not enough to commit to it or to write a prompt that invokes it well.

How to read it:

• If ~/.claude/skills/{skill-name}/SKILL.md exists locally, Read it.
• For sales-* skills, WebFetch directly from this repo: https://raw.githubusercontent.com/sales-skills/sales/main/skills/{skill-name}/SKILL.md — e.g., for sales-mailshake: https://raw.githubusercontent.com/sales-skills/sales/main/skills/sales-mailshake/SKILL.md.
• For non-sales-* skills (third-party), look up {org}/{repo} in ~/.claude/skills/sales-do/references/skill-sources.md if installed and fetch the same skills/{skill-name}/SKILL.md path under that repo.

After reading, ground your recommendation in something concrete from the SKILL.md (its scope, a sub-flow, its argument-hint shape, or a "Do NOT use for..." negative trigger). Align any generated invocation with the platform skill's argument-hint. If the platform skill turns out not to fit the user's situation, swap to another or handle the question here directly rather than recommending a poor fit.

Related skills

• /sales-social-listening — Social listening strategy — brand monitoring, sentiment, competitive intel, crisis detection, tool comparison
• /sales-brand24 — Brand24 platform help — affordable social listening alternative with MCP server
• /sales-awario — Awario platform help — budget social listening with Boolean search and Awario Leads
• /sales-mention — Mention platform help — simple affordable brand monitoring, REST API
• /sales-brandwatch — Brandwatch platform help — enterprise consumer intelligence, deep audience research
• /sales-meltwater — Meltwater platform help — enterprise media intelligence, journalist database
• /sales-sproutsocial — Sprout Social platform help — social management + listening add-on
• /sales-threadlytics — Threadlytics platform help — Reddit-specific monitoring
• /sales-social-media-management — Social media management strategy across tools
• /sales-ai-visibility — AI visibility monitoring — track brand in LLMs
• /sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do

Examples

Example 1: Set up brand monitoring with image recognition

User says: "I want to track our logo appearing in social media images and news articles using Talkwalker" Skill does:

1. Reads platform-guide.md for Image API details
2. Explains the three detection types: logo, object, scene
3. Provides cURL example for logo detection endpoint
4. Notes that image URL prefixes must be whitelisted by Talkwalker support
5. Suggests combining Search API keyword monitoring with Image API visual detection Result: Dual monitoring setup covering both text mentions and visual brand appearances

Example 2: Build an API pipeline to export mentions to a data warehouse

User says: "I need to pull all brand mentions from Talkwalker into BigQuery daily" Skill does:

1. Reads platform-guide.md for Search API and Streaming API details
2. Recommends Streaming API for continuous ingestion vs Search API for batch
3. Provides Python recipe for paginated Search API extraction
4. Warns about data export restrictions (FB/IG aggregated only, Twitter limited)
5. Suggests credit-efficient pagination strategy (hpp=500, manage offset limits) Result: Working pipeline architecture with code examples and cost optimization

Example 3: Reduce noise in social listening results

User says: "Our Talkwalker monitoring returns thousands of irrelevant mentions every day" Skill does:

1. Diagnoses likely cause: overly broad queries, missing NOT exclusions
2. Explains Boolean refinement: exact phrases, NOT operator, topic filters
3. Suggests testing with quicksearch endpoint first (240 calls/min, no project needed)
4. Recommends using noise_level field to filter low-quality content programmatically
5. Shows how to use topic and channel filters in project-scoped queries Result: Refined monitoring with significantly less noise

Troubleshooting

API returns empty or limited results

Symptom: Search API calls return few or no results despite matching content visible in the UI Cause: Using quicksearch endpoint (non-project) which excludes all social media. Or access_token=demo which only works with cats/dogs queries. Solution: Use the project-scoped endpoint (/api/v1/search/p/<project_id>/results) with a valid paid token. Verify your token type is read_only or read_write, not demo.

Streaming API connection drops

Symptom: Real-time stream stops delivering results or returns CT_CONTROL messages without data Cause: Streaming connections can be interrupted by network issues or rule changes. Manual tag updates and rule-applied tags don't transmit through streams. Solution: Implement reconnection logic with exponential backoff. Monitor CT_CONTROL messages for stream status. For rules and tags that need to appear in stream output, configure them before starting the stream — changes mid-stream require reconnecting.

Credit consumption unexpectedly high

Symptom: API credits deplete faster than expected Cause: Each result costs 1 credit (min 10/call). AI summaries cost 20 credits. Broad queries with high hpp values drain credits quickly. Solution: Use hpp strategically — request only what you need. Filter queries tightly with Boolean operators and time ranges. Avoid enabling summarize=true on high-volume endpoints. Track credits per call and set internal budgets per integration.