> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NielsenIQ

> Connect BonData to NielsenIQ for retail measurement and consumer POS market data

NielsenIQ (NIQ) provides retail measurement and consumer point-of-sale data covering sales, distribution, and market share across categories, markets, and time periods. With BonData, you can connect to your NielsenIQ data services to pull measurement facts and reference dimensions within Agent workflows.

## NielsenIQ API Key Setup

NielsenIQ data services authenticate with client credentials issued by NIQ. Follow these steps to connect BonData.

### Step 1: Request API Access from NielsenIQ

1. Contact your **NielsenIQ account representative** or NIQ Connect administrator to request API access for your subscription
2. NIQ provisions a **Client ID** and **Client Secret** (or an **API Key**) scoped to the datasets included in your contract
3. Note the **base URL** of the NIQ data service or Connect API assigned to your account

<Note>
  NielsenIQ data is licensed per subscription. The categories, markets, and periods available through the API are limited to what your organization has purchased.
</Note>

### Step 2: Confirm Your Dataset Scope

1. In NIQ Connect, review the categories and markets included in your entitlement
2. Confirm which **facts/measures** (for example sales value, sales volume, and distribution) your subscription exposes

### Step 3: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **NielsenIQ**
2. Enter your **Client ID** and **Client Secret** (or **API Key**)
3. Click **Connect** - BonData validates the credentials and retrieves your available datasets

## Required Fields

| Field         | Description                                                                              |
| ------------- | ---------------------------------------------------------------------------------------- |
| Client ID     | Client identifier provisioned by NielsenIQ for your subscription                         |
| Client Secret | Client secret paired with the Client ID                                                  |
| API Key       | API key issued by NielsenIQ (used in place of client credentials for some data services) |

## Available Data

Once connected, BonData can sync the following NielsenIQ data:

* **Products / Items** - Product and item reference data including UPC/EAN, brand, and manufacturer
* **Markets** - Retail markets, channels, and geographies used to slice measurement data
* **Periods** - Time periods (weekly, monthly, quarterly) available in your subscription
* **Categories** - Category and subcategory hierarchy used to organize items and facts
* **Facts / Measures** - Measurement values such as sales value, sales volume, and distribution (ACV/PCV)