# AppTweak API Documentation

> Direct access to more than 5 million apps from Apple App Store
 and Google Play Store in 100+ countries via a JSON HTTP API.

## API Reference
- [App Paid Keywords](https://developers.apptweak.com/reference/app-paid-keywords.md): Get an app's all time paid keywords, and the number of bids found for each.
- [Keywords Share Of Voice](https://developers.apptweak.com/reference/keywords-share-of-voice.md): Get the applications that bid on a given keyword and their dates of occurrence.
- [App Category Ranking - Current](https://developers.apptweak.com/reference/app-category-ranking-current.md): Returns the most recent ranking of an app in its category.
- [App Category Ranking - History](https://developers.apptweak.com/reference/app-category-ranking-history.md): Returns historical rankings of an app in its main category & the category "All".
- [App Metadata - Current](https://developers.apptweak.com/reference/app-metadata-current.md): Returns metadata from an app that AppTweak has been able to gather from the App Store or the Google Play Store. The data is fetched daily.
- [App Metadata - History](https://developers.apptweak.com/reference/app-metadata-history.md): Returns metadata changes from an app that AppTweak has been able to gather from the App Store or the Google Play Store. The data is fetched daily.
- [App Metadata](https://developers.apptweak.com/reference/app-metadata.md): Returns metadata from an app that AppTweak has been able to gather from the App Store or the Google Play Store.
- [App Metrics - Current](https://developers.apptweak.com/reference/app-metrics-current.md): Get the most recent metrics of an app (downloads, revenues, ratings & app power).
- [App Metrics - History](https://developers.apptweak.com/reference/app-metrics-history.md): Get the historical metrics of an app (downloads, revenues, ratings & app power).
- [App Metrics](https://developers.apptweak.com/reference/app-metrics.md): Returns analytics data for applications that AppTweak has been able to gather or estimate.
- [App Reviews Displayed](https://developers.apptweak.com/reference/app-reviews-displayed.md): Get the top displayed reviews entries about a specific app on the App Store or Google Play in the selected country and based on the given sort parameter.
- [App Reviews Search](https://developers.apptweak.com/reference/app-reviews-search.md): Get all the reviews entries about a specific app on the App Store in the selected country and based on several criteria like date, rating or even to search for a specific word or expression in the reviews's body.
- [App Reviews Stats](https://developers.apptweak.com/reference/app-reviews-stats.md): Get all the stats related to the reviews entries about a specific app on the App Store in the selected country and based on several criteria like date, rating or even to search for a specific word or expression in the reviews's body.
- [App Reviews](https://developers.apptweak.com/reference/app-reviews.md): Fetch reviews that AppTweak has been able to gather about a specific app on the App Store or Google Play in the selected country.
- [/cpps/breakdown/apps](https://developers.apptweak.com/reference/cpp-by-app.md)
- [/cpps/breakdown/categories](https://developers.apptweak.com/reference/cpp-by-category.md)
- [/cpps/breakdown/dnas](https://developers.apptweak.com/reference/cpp-by-dna.md)
- [/cpps/breakdown/keywords](https://developers.apptweak.com/reference/cpp-by-keyword.md)
- [/cpps/keywords](https://developers.apptweak.com/reference/cpp-keywords.md)
- [CPP Intelligence](https://developers.apptweak.com/reference/cpp-intelligence.md): AppTweak's CPP Intelligence endpoints provides deep insights into Custom Product Pages (CPPs) available on the Apple App Store. You can retrieve CPP creatives date (icons, screenshots) based on app, keyword, category, or DNA segmentation.
- [DNA Charts - Current](https://developers.apptweak.com/reference/dna-charts-current.md): Returns the most recent top chart for the App Store or Google Play Store. The top 500 applications are available for free, paid, or grossing apps.
- [DNA Charts](https://developers.apptweak.com/reference/dna-charts.md): Get the most popular applications for a given DNA and type in a country for a device.
- [Featured Content Details](https://developers.apptweak.com/reference/featured-content-details.md): Allows you to fetch all the featurings that AppTweak has been able to gather on App Store or Google play in the selected countries on a given period.
- [Featured content](https://developers.apptweak.com/reference/featured-content.md): Find out exactly when and in which lists a selected app was featured.
- [In-App Events List](https://developers.apptweak.com/reference/in-app-events-history.md): Returns all the In-App events or Promotional Content of an app on the selected date range.
- [In-App Events Metadata](https://developers.apptweak.com/reference/in-app-events-metadata.md): Returns the event metadata of a given list of event IDs
- [In-App Events](https://developers.apptweak.com/reference/in-app-events.md): Get In-App event metadata from the App Store or Promotional Content metadata from Google Play
- [Keyword Metrics by App](https://developers.apptweak.com/reference/keyword-metrics-by-app.md): KPIs that are specific to a keyword and an app.
- [/apps/keywords-rankings/current.json](https://developers.apptweak.com/reference/keyword-metrics-by-app-current.md)
- [/apps/keywords-rankings/history.json](https://developers.apptweak.com/reference/keyword-metrics-by-app-history.md)
- [Keyword Metrics](https://developers.apptweak.com/reference/keyword-metrics.md): Returns analytics data for different keywords that AppTweak gathers or estimates.
- [Keyword Metrics - Current](https://developers.apptweak.com/reference/keyword-metrics-current.md): Get the most recent metrics of a keyword (volume, max volume, difficulty, brand, total results, max reach).
- [Keyword Metrics - History](https://developers.apptweak.com/reference/keyword-metrics-history.md): Get historical metrics of a keyword (volume) for a given date range. If you want to have live data for keyword metrics, please see <a href="https://developers.apptweak.com/reference/keyword-metrics-current" target="_blank">Keyword Metrics - Current</a>
- [Keyword Live Search](https://developers.apptweak.com/reference/keyword-search.md): Returns the list of apps resulting from a live keyword search on the mobile app stores. Historical results are also available.
- [Keyword Live Search With Ads - Current](https://developers.apptweak.com/reference/keyword-live-search-current-ads.md): Returns the app results (including ads) of a live search on the store for a given keyword.
- [Keyword Live Search - Current](https://developers.apptweak.com/reference/keyword-search-current.md): Returns the organic app results of a live search on the store for a given keyword.
- [Keyword Live Search - History](https://developers.apptweak.com/reference/keyword-search-history.md): Returns historical app results of a search for a given keyword. For each day in the requested period, this query will return the search result if AppTweak made a search on that date for that keyword.
- [Keyword Suggestions](https://developers.apptweak.com/reference/keyword-suggestions.md): Returns keywords suggestions by app, category, trend or volume change.
- [Discover](https://developers.apptweak.com/reference/keyword-suggestion-trending.md): Returns a list of trending keywords. Trending keywords are displayed in the search result of the app store when the user has not typed anything.
- [Top Installs](https://developers.apptweak.com/reference/keyword-suggestions-app.md): Returns a list of recommended keywords for which an app is performing well on.
- [Top Category](https://developers.apptweak.com/reference/keyword-suggestions-category.md): Returns the most popular keyword list for a given category.  The keyword list is sorted by descending keyword volume.
- [Top Charts](https://developers.apptweak.com/reference/top-charts.md): Get the most popular applications for a category and type in a country for a device.
- [Top Charts - Current](https://developers.apptweak.com/reference/top-charts-current.md): Returns the most recent top chart for the App Store or Google Play Store. The top 500 applications are available for free, paid, or grossing apps.
- [Top Charts - History](https://developers.apptweak.com/reference/top-charts-history.md): Returns historical top charts for the App Store or Google Play Store. The top 500 applications are provided for free and paid, or grossing apps.
- [Twin App](https://developers.apptweak.com/reference/twin-app-endpoint.md): Returns an array of application with their twin application from the other store (Apple Store vs Google Play Store)
- [Countries](https://developers.apptweak.com/reference/countries-1.md): Get the list of country codes and names for a given store. Go to the <a href="https://developers.apptweak.com/reference/languages" target="_blank">Languages endpoint</a> to get the list of languages.
- [Countries](https://developers.apptweak.com/reference/countries-languages.md): Get information about the countries currently supported in AppTweak
- [DNA](https://developers.apptweak.com/reference/dnas-1.md): Get the list of AppDNA and/or GameDNA available in AppTweak
- [DNA](https://developers.apptweak.com/reference/dnas-overview.md): Get information about the AppDNA and GameDNA currently supported in AppTweak
- [Languages](https://developers.apptweak.com/reference/languages-overview.md): Get information about the countries currently supported in AppTweak
- [Languages](https://developers.apptweak.com/reference/languages-1.md): Get the list of language and country codes for a given store and optionally a list of countries
- [Tracked Applications](https://developers.apptweak.com/reference/tracked-applications-summary.md): Ensure AppTweak fetches data for tracked apps in the future.
- [Tracked applications - Create](https://developers.apptweak.com/reference/tracked-applications-create.md): Start tracking an application with the API
- [Tracked applications - Delete](https://developers.apptweak.com/reference/tracked-applications-delete.md): Deleting a tracked app will stop its tracking. When you stop tracking an app, there's no guarantee you will still have up-to-date information about this application.
- [Tracked applications - List](https://developers.apptweak.com/reference/tracked-applications-list.md): Get the list of your tracked applications
- [Tracked applications - Update](https://developers.apptweak.com/reference/tracked-applications-update.md): Update applications that you're tracking by changing the app id, country, language and device
- [API Credits Balance](https://developers.apptweak.com/reference/usage.md): Get an overview of your remaining credits, the amount of recurrent credits and additional credits.
- [App Store Connect by In-App Event](https://developers.apptweak.com/reference/app-store-connect-by-in-app-event.md): The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak with a breakdown by in-app event.
- [App Store Connect by Device](https://developers.apptweak.com/reference/app-store-connect-device.md): The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak with a breakdown by device.
- [App Store Connect](https://developers.apptweak.com/reference/app-store-connect.md): The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak.
- [Google Play Console - Organic Search](https://developers.apptweak.com/reference/google-play-console-store-performance-organic-search.md): With the Organic Search endpoint you can fetch all the keywords that drove organic traffic to any connected app over the selected date range. You will also get the breakdown of Store Listing Visitors & Store Listing Acquisitions per keyword.
- [Google Play Console - Store Performance](https://developers.apptweak.com/reference/google-play-console-store-performance.md): With the Store Performance endpoint you can fetch Store Listing Visitors & Store Listing Acquisitions for any connected app.
- [Google Play Console](https://developers.apptweak.com/reference/google-play-console.md): Get Store Listing Acquistions and Store Listing Vistors data from your Google Play Console
- [Google Play Reports](https://developers.apptweak.com/reference/google-play-reports.md): The integrations reports endpoints allow you to fetch different reports related to your integrations in AppTweak.
- [API Changelog](https://developers.apptweak.com/reference/changelog.md): See detailed API changes — new features, endpoint updates, and fixes.
- [Overview](https://developers.apptweak.com/reference/overview.md): This page will help you get started with AppTweak's App Store API.
- [MCP](https://developers.apptweak.com/reference/mcp.md)
- [Make Your First API Request](https://developers.apptweak.com/reference/your-first-request.md)
- [How to find App IDs?](https://developers.apptweak.com/reference/how-to-find-app-ids.md): You must supply the app ID in order to use the API to retrieve data. To do this, there are several methods.
- [HTTP Errors](https://developers.apptweak.com/reference/http-errors.md): Most common http errors occurring on this API and how to solve them
- [Postman Collection](https://developers.apptweak.com/reference/postman-collection.md)
- [API Data Pricing](https://developers.apptweak.com/reference/pricing-table.md)
- [App Store Categories](https://developers.apptweak.com/reference/app-store-categories.md)
- [Supported Countries & Languages](https://developers.apptweak.com/reference/country-codes.md)
- [Google Play Store Categories](https://developers.apptweak.com/reference/google-play-store-categories.md)

## Recipes
- [App Keyword Ranking Evolution](https://developers.apptweak.com/recipes/app-keyword-ranking-evolution.md)
- [App Metrics Extract](https://developers.apptweak.com/recipes/app-metrics-extract.md)
- [Featured Content vs Download Estimates](https://developers.apptweak.com/recipes/featured-content-vs-download-estimates.md)
- [Get App Reviews](https://developers.apptweak.com/recipes/get-app-reviews.md)
- [Top Keywords by app, country and brand](https://developers.apptweak.com/recipes/top-keywords-by-app-country-and-brand.md)
- [Trending Keywords per Region](https://developers.apptweak.com/recipes/trending-keywords-per-region.md)
- [Volume History - multi-countries extract](https://developers.apptweak.com/recipes/volume-history-multi-countries-extract.md)