apple-search-ads-js

Apple Search Ads for Node.JS

Opinionated Apple Search Ads API client library for Javascript

Installation

$ npm install apple-search-ads-js

Features

• Built according to the latest Apple Search Ads Docs
• This library offers an opinionated execution to the ASA API.

Example

const AsaApi = require('apple-search-ads-js');
const Certificate = AsaApi.Certificate;
const ASAApiError = AsaApi.ASAApiError;

const asaApi = new AsaApi('<org-id-here>', new Certificate(
    '<your-pem>.pem',
    '<your-key>.key'
));

(async () => {
    try {
        const selector = {
            conditions: [
                {field: 'status', operator: 'EQUALS', values: ['ENABLED']}
            ]
        };
        
        // retrieve enabled campaigns with 15 results per page
        const resp = await asaApi.campaigns.find(selector, {pageSize: 15});
        const campaigns = resp.results;

        while (campaigns && campaigns.length > 0) {
            for (let campaign of campaigns) {
                // Do something with campaign
                console.log(`Fetched campaign: ${campaign.name}`);
            }
    
            if (cResp.next) {
                cResp = await cResp.next();
                campaigns = cResp.results;
            } else {
                campaigns = undefined;
            }
        }
    } catch (err) {
        if (err instanceof ASAApiError) {
            err.print(console);
        }
        throw err;
    }
});

Usage

Authentication

(taken from Apple Search Ads Authentication docs)

Generate an API Certificate

To establish SSL authentication, do the following steps:

• Click on the upper right-hand carrot and select Settings.
• Click on API tab, then select Create API Certificate.
• Select certificate permissions based on roles. For more information, refer to the roleNames field in the UserAcl object.
• Click Create.
• To download the API certificate, select Action, then Download.

Note: Certificates expire after 24 months, at which time you can download a new PEM and key.

Grab your org id

Your OrgId is the account id shown when you click on your name in the top right corner in Apple Search Ads UI.

Use the downloaded pem and key when initializing

const asaApi = new AsaApi('<org-id>', new Certificate(
    '<your-pem>.pem',
    '<your-key>.key'
));