December 2, 2020 update:
  • The Poly website ( and Poly API will be shut down on June 30, 2021. Uploading of new assets will be disabled two months earlier, on April 30, 2021.
  • Previously uploaded assets will remain available and can be downloaded from until June 30, 2021.

iOS Quickstart

This guide explains how to build and run the Poly API sample apps for iOS. Each sample app downloads an asset at runtime and displays it. We provide samples for SceneKit and ARKit.


This quickstart assumes you are using Xcode 9.0 or higher. You also need:

  • Access to the internet on your test device or simulator.
  • A Google account, for getting an API key.

Get an API key

Get an API key

  • If you aren't already signed in, you'll be asked to sign in with a Google account or create one.

  • In the dialog box, either select an existing API Console project or create a new project

  • Click Next to enable the Poly API and receive your API key. The API key is used to identify your app and enforce usage limits.

You can also create, view, and manage your projects, APIs, and API keys at the Google APIs Console.

Prepare the sample project

  1. Download the samples package.

  2. Choose either the ARKit sample or the SceneKit sample and open it in Xcode.

    The sample apps are configured to run on iOS 11. To target a different version, change your build settings in the project area of Xcode.

  3. Enter the API key. In Xcode, open the file ViewController.m (ARKit) or GameViewController.m (SceneKit) and enter your API key as shown below:

    // IMPORTANT: replace this with your project's API key.
    static NSString * const POLY_API_KEY = @"YOUR KEY";

Run the sample

Make sure your device is configured and connected to Xcode. Click Run. You should see a piano render.