Common Issues

Connection issues

My API key is not being accepted

Double-check that you're copying the full API key from Appfollow Settings → API with no leading or trailing spaces. If the key still fails, regenerate it in Appfollow and use the new one. Make sure your Appfollow account is active and not suspended.

The data flow fails immediately after authentication

This usually means the selected entity isn't accessible with your API key's permission level. Check that your Appfollow plan includes API access and that the entity you selected (e.g., Stat reviews or Ratings) is available on your subscription tier.

Missing data

No data appears for Stat reviews or Ratings

Appfollow only returns data for apps that are actively tracked in your account. If you haven't added any apps to a list or collection in Appfollow, these entities will return empty. Log in to Appfollow and confirm at least one app is being monitored.

App collections or App lists return empty results

This happens when no collections or lists have been created in your Appfollow workspace. Create at least one list or collection in Appfollow, then re-run the data flow.

Rating data is missing for certain countries

Country-level rating breakdowns depend on your Appfollow subscription. Some plans only include global or top-market data. Check your plan's country coverage in Appfollow's documentation or contact Appfollow support to confirm what regions are included.

Permission errors

I get a "403 Forbidden" or "Unauthorized" error

This indicates the API key doesn't have the right permissions for the entity you're trying to access. Some Appfollow features are restricted by role or plan. Verify that your user role in Appfollow has API access enabled, and that your plan supports the entity you're querying.

Data discrepancies

Rating counts in Coupler.io don't match what I see in the Appfollow dashboard

Appfollow's dashboard may display real-time or cached figures, while the API returns data at a specific snapshot time. If you're comparing numbers, make sure you're looking at the same date range and store (App Store vs. Google Play) in both places. Rating deltas can also differ if the dashboard uses a rolling window.

Review sentiment percentages look different between exports

Sentiment classification in Appfollow can be recalculated retroactively when their models are updated. If you notice historical figures changing, this is expected behavior from Appfollow's side — it's not a Coupler.io sync issue.

Rate limits

The data flow fails with a rate limit error

Appfollow enforces API rate limits based on your plan. If you're running multiple data flows simultaneously or refreshing very frequently, you may hit these limits. Stagger your data flow schedules and avoid running more than one Appfollow data flow at the same time to stay within limits.