# Talkwalker setup for PopMCP

You paste one value into PopMCP: the API access token your Talkwalker customer success manager gives you.

- Auth: API credentials
- Setup time: 1 min once you have the token
- API base URL: https://api.talkwalker.com
- Credentials screen: https://app.talkwalker.com
- Provider docs: https://developer.talkwalker.com/docs/

## Approval required before this works

Talkwalker has no self-service way to get API access. Its documentation says to apply for an access token through your customer success manager, so you need a Talkwalker account with API access.

- Typical wait: None if you already have a token. Otherwise it depends on your customer success manager.
- Cost: PopMCP adds nothing. Ask your Talkwalker customer success manager about pricing. API calls spend the credits in your subscription, which reset each month on your subscription day.
- Blocked until approved: Without a token nothing connects. Changes to topics, documents, streams and panels also need a read_write token rather than a read_only one.
- Works meanwhile: Talkwalker's own app works on its own. Nothing in PopMCP works until the token is accepted.

## Before you begin

- A Talkwalker account with API access. Talkwalker issues API tokens on request, so if you have none yet, ask your customer success manager
- A read_write token if the AI should change topics, documents, streams or panels. A read_only token is enough for search and numbers

## Get your credentials

### 1. Ask for an API access token

Talkwalker's [developer documentation](https://developer.talkwalker.com/docs/getting-started/access-token) says to request tokens from your customer success manager, and it names no page in the app where you make one yourself. Ask for a read_write token if the AI should be able to change things, or a read_only token if it should only read. Also tell them which projects the token should reach.

Screen: https://developer.talkwalker.com/docs/getting-started/access-token

### 2. Paste it into PopMCP and choose the project

In PopMCP, paste the token into Access token and connect. PopMCP checks it with Talkwalker and lists the projects it reaches. Choose the project and the workspace it belongs in. A token linked to no project shows Global search only.

## Fields PopMCP asks for

- Access token (accessToken) [required]: Ask your Talkwalker customer success manager for an API access token, then paste it here. Stored encrypted.

## Verify

PopMCP marks the Talkwalker connection Verified with your project's name and notes your monthly credits left. Asking the AI for a project overview returns your topics, filters, panels and credits.

## Troubleshooting

### Talkwalker did not accept this access token

Cause: undefined

Fix: Check that you copied all of it. If it still fails, the token may be inactive, so ask your customer success manager for a current one.

### The picker shows Global search only

Cause: undefined

Fix: This token is linked to no project. Ask your customer success manager to link your projects to it, then connect again.

### A change is refused with insufficient access rights

Cause: undefined

Fix: This is a read_only token. Ask your customer success manager for a read_write token, then connect again with it. PopMCP's own write setting must also allow changes.

### Calls stop with no credits left

Cause: undefined

Fix: The account has spent its credits. They reset each month on your subscription day. Ask the AI for your credits, or ask your customer success manager for more.

### Call limit exceeded

Cause: undefined

Fix: Talkwalker limits each endpoint per minute. Reading a stream or collector is limited to 5 calls a minute. Wait a minute and try again.

### Global search is disabled for this account

Cause: undefined

Fix: Talkwalker has turned off the global index for your account. Search inside your project instead.

### Listening to a stream returns nothing

Cause: undefined

Fix: A stream only delivers what arrives while connected, so an empty answer is normal. To gather results over time, ask the AI to create a collector and read it later. An active collector spends a credit per new result, so pause it when you are done.

### Facebook, Instagram or TikTok posts are missing from results

Cause: undefined

Fix: Talkwalker does not export those posts through its API. Ask for a histogram instead, which gives the numbers.

### An export ended with result_limit_reached

Cause: undefined

Fix: There were more results than the limit. PopMCP sets the limit to 1,000 unless you ask for more, and exporting the same period again spends credits again, so ask for a larger limit on a smaller period.

---

Source: https://www.docs.popmcp.com/docs/integrations/talkwalker/