Common Issues

Connection issues

My API key is rejected when I try to connect

Double-check that you're copying the full API key from Appfigures → Account Settings → API. Make sure there are no trailing spaces or line breaks. If you recently regenerated your key, update it in your Coupler.io data flow as well — the old key is immediately invalidated.

The data flow connects but returns no rows

This usually means your start date is set too far in the future, or Appfigures hasn't synced recent data from the store yet. Try moving the start date back a few days using the date picker. Also check the Statuses entity to confirm your store accounts are syncing correctly.

Missing data

I'm missing data for one of my apps

Confirm that the app is properly linked in your Appfigures account — go to Appfigures and check under Apps. If a store account has a sync error, the Statuses entity in Coupler.io will reflect this. Re-authenticating the store connection in Appfigures often resolves it.

Google Play data isn't showing up, only Apple data

The search_store parameter defaults to apple. To retrieve Google Play data, set the parameter value to google in your data flow's advanced settings.

Subscription data shows zeros for some periods

Appfigures subscription data can have a processing lag — typically 24–72 hours behind real time. If you're querying very recent dates, wait a day and re-run. Also confirm your app uses Apple or Google's subscription billing, as third-party billing systems are not tracked.

Permission errors

I get a "403 Forbidden" error

This means your API key doesn't have the required permissions. In Appfigures, check that your account role has access to the entities you're requesting. Some data (like ad spend) may require elevated permissions or a specific Appfigures plan tier.

Data discrepancies

Revenue in Coupler.io doesn't match what I see in App Store Connect

Appfigures reports proceeds (revenue after store fees) separately from gross revenue. Make sure you're comparing the right metric. There can also be a 1–2 day reporting delay from Apple, so recent totals may differ until the store finalizes its numbers.

Download counts differ between Reports sales and the app store dashboard

This can happen if the group_by parameter is set to a dimension that causes double-counting (for example, grouping by both product and country). Try grouping only by date to get a simple total, then compare.

Rate limits

My data flow fails with a rate limit error

Appfigures enforces API rate limits based on your plan. If you're pulling multiple entities in the same data flow across long date ranges, try splitting them into separate data flows. Reducing the date range per run also helps stay within limits.