Infegy Starscape: Setup guide

Infegy Starscape: Setup guide#

This guide explains how to collect data from Infegy Starscape.

Introduction#

Infegy Starscape is a social intelligence platform that analyzes online conversations across social networks, news sites, blogs, forums, and reviews. The Infegy Starscape connector fetches the individual posts matching a query you define, together with their sentiment, emotions, themes, interests, and author demographics.

Infegy Starscape is the successor to the Infegy Atlas platform, and the connector collects the same kind of data as the Infegy Atlas connector.

Each row in your data extract represents one post, with all the post fields Infegy Starscape returns as columns. Adverity performs the following conversions on the data it collects:

  • Adds a day column containing the publication date of the post.

  • Returns the channels, emotions, themes, and source_interests fields as comma-separated values.

  • Replaces the sentiment and is_reply_or_share codes returned by Infegy Starscape with their labels, for example Positive, Neutral, or Negative for sentiment.

Limitations#

Collecting data from Infegy Starscape comes with the following limitations:

  • You cannot choose which Infegy dataset to query. The connector always fetches data from the Infegy Starscape Social Dataset.

  • The connector collects posts only. Infegy Starscape does not aggregate the data before returning it, so you must aggregate metrics such as post volume or average sentiment after collecting the data.

  • The date range you can fetch depends on your Infegy API key. Depending on your Infegy plan, production keys cover data published from 1 January 2007 onwards, while sandbox keys are limited to the last seven days. If the date range of a fetch extends beyond the range your key allows, Adverity fetches the part of the range that is available and completes the fetch with a warning on the Activity page.

  • Every fetch consumes the API quota of your Infegy Starscape account.

  • Infegy applies rate limits to its API. If Adverity reaches a rate limit during a fetch, it waits before retrying, which extends the duration of the fetch.

Prerequisites#

Before you start collecting data from Infegy Starscape, perform all of the following actions:

  • Ensure you have an Infegy Starscape account with API access enabled.

  • Ensure your Infegy Starscape API key has access to the Social Dataset. An API key only gives access to the datasets it has been granted.

Creating a datastream to collect data from Infegy Starscape#

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Infegy Starscape.

Authorization: Allow Adverity to access Infegy Starscape#

Before creating an authorization to give Adverity access to Infegy Starscape, perform the following actions:

To set up a new authorization to fetch data from Infegy Starscape, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Infegy Starscape using your credentials.

  2. Click Next.

  3. In API key, enter your Infegy Starscape API key.

  4. Click Authorize.

As a result, Adverity has access to Infegy Starscape using the credentials you provided.

Configuration: Choose the data you want to collect from Infegy Starscape#

To choose what data to collect and customize the Infegy Starscape datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Query, define which posts to collect. This field is required. You can enter either of the following:

    • A keyword or phrase. Adverity collects the posts that contain it in the title or the body of the post.

    • An Infegy query object. Build the query in the Infegy Starscape dashboard, then copy it into this field. Use an Infegy query object when you need operators that a keyword search cannot express, such as combining several conditions.

  3. (Optional) In Channels, Country, and Language, select the channels, countries, and languages for which to collect data. For each field, you can choose to include or exclude specific items, or select all items.

    The available options depend on your Infegy Starscape account. If you leave a field set to all items, Adverity does not filter the data by that field.

As a result, Adverity fetches the posts matching your query from Infegy Starscape.

What’s next?#

Contents