Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

gatsby-source-app-store

Gatsby source plugin that pulls data from App Store such as app information and user reviews. Great for building landing pages for apps with data for user testimonials,scores and release notes pulled straigh from app store

Demo

Description

This plugin pull data from Apple App Store using app-store-scraper. It fetches information about the app such as category, description, release notes, etc. as well user reviews. The amount of user reviews limited to the amount you can find on Apple’s App Store website.

How to install

To install run

npm install gatsby-source-app-store
// or 
yarn add gatsby-source-app-store

How to use

// In your gatsby-config.js
module.exports = {
  plugins: [
    // Add the plugin to your gatsby-config
    {
      resolve: `gatsby-source-app-store`,
      options: {
        apps: ["app.sleepcircle.application"], // required
        country: "fi" // optional, can affect the language of reviews
      },
    },
  ],
}

Available options

Name Type Description
apps array of strings Required., list all the application bundle ids for which you want to fetch data for.
country string Optional. language code from which which the data will be fetched. Will affect the language of the reviews

How to query for data

Query all apps

{
  allApp {
    edges {
      node {
        appId
        currentVersionScore
        requiredOsVersion
        size
        title
        url
        developerUrl
        developerWebsite
        score
        genres
        currentVersionReviews
        currency
        contentRating
        price
        languages
        released
        developer
        developerId
        version
        releaseNotes
        updated
        icon
      }
    }
  }
}

Query single app

{
  app(appId: {eq: "app.sleepcircle.application"}) {
    appId
    contentRating
    currency
    currentVersionReviews
    currentVersionScore
    description
    developer
    developerId
    developerUrl
    developerWebsite
    free
    genreIds
    genres
    id
    icon
    languages
    price
    primaryGenreId
    primaryGenre
    releaseNotes
    released
    requiredOsVersion
    score
    size
    title
    updated
    version
    url
  }
}

Query all reviews

{
  allReview {
    nodes {
      appId
      id
      score
      text
      title
      url
      userName
      userUrl
      version
    }
  }
}

Query a single review for an app

{
  review(appId: {eq: "app.sleepcircle.application"}) {
    appId
    id
    score
    text
    title
    url
    userName
    userUrl
    version
  }
}

When do I use this plugin?

This plugin is perfect for the following use cases:

  1. You’ve developed an iOS app and want to show user reviews (as testimonials) on your app’s website
  2. You’ve a developer portfolio of the iOS apps you’ve built and want to show information such as ratings, reviews, etc to richen the portfolio site
  3. You want to do competetive analysis between different apps

How to contribute

All contributions are welcome

© 2023 Gatsby, Inc.