FAQ

Where do I find my Appfigures API key?

Log in to Appfigures, go to Account Settings, and select the API tab. Your personal API key is listed there. If you don't see an API tab, your account may not have developer access enabled — contact Appfigures support to request it.

Can I pull data from multiple app stores in one data flow?

Each data flow instance is tied to one search_store value (e.g., apple or google). To combine data from multiple stores, create a separate data flow for each store and use Coupler.io's Append transformation to merge them into a single destination.

Can I track multiple apps at once?

Yes — Appfigures aggregates data across all apps in your account by default. Use the group_by: product setting (the default) to see data broken down by individual app. If you want a single total across all apps, switch to grouping by date or country.

Why does my revenue data look different from App Store Connect?

There are two common reasons: (1) Appfigures separates proceeds (after store fees) from gross revenue — make sure you're using the right metric. (2) Apple finalizes reporting data with a 24–72 hour delay, so very recent figures may not match yet. See the Data Overview article for a breakdown of revenue metrics.

Can I use Appfigures data with AI tools?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Cursor, Perplexity, and OpenClaw. You can send your Appfigures reports directly to these tools to get AI-generated insights, trend summaries, or recommendations based on your app performance data.

What's the difference between Reports ads and Reports adspends?

Reports ads contains performance metrics — impressions, clicks, and engagement. Reports adspends contains cost data — how much you spent on each campaign. To calculate metrics like CPC or ROAS, you'll want to join both entities using Coupler.io's Join transformation.

How far back can I pull historical data?

The date range depends on your Appfigures plan and the data available from each store. Use the date picker to set a start date as far back as you need — but note that very large date ranges combined with daily grouping can slow down the data flow or trigger rate limits. Start with a 90-day window and expand from there.

Can I schedule automatic data refreshes?

Yes, once your data flow completes a successful manual run, you can set up a schedule to refresh data automatically. For more on timing and frequency, see the Best Practices article.

For a full breakdown of available metrics and dimensions, see the Data Overview article. For help with errors or missing data, check Common Issues.