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

# Export user profiles to an audience

> Learn how to export user profiles to an audience.

export const ApplicationID = () => <Tooltip tip="A unique alphanumeric string that identifies an Algolia application." cta="Application ID (dashboard)" href="https://dashboard.algolia.com/account/api-keys">
    application ID
  </Tooltip>;

export const APIKey = () => <Tooltip tip="An alphanumeric string that controls access to the Algolia APIs. It defines what actions are allowed, such as searching an index or adding new records." cta="API key" href="/doc/guides/security/api-keys">
    API key
  </Tooltip>;

export const Affinity = () => <Tooltip tip="Affinity is a preference score that Algolia calculates for each user based on their behavior. It reflects how likely a user is to prefer a specific facet-value pair and helps personalize their search results." cta="Affinity" href="/doc/guides/personalization/advanced-personalization/configure/prerequisites/consider-requirements-limits#affinities">
    affinity
  </Tooltip>;

This guide demonstrates how to fetch and browse user profiles using Algolia's Advanced Personalization API. The provided code snippets offer a straightforward way to interact with the API and retrieve user data for segmentation purposes.

Exporting an audience lets you create groups of users who share a specific <Affinity />,
so you can run focused email or ad campaigns.
For example, you could export an audience of users with a high affinity for camping or hiking and send them promotional content about outdoor gear.

## Before you begin

Ensure you have a query string builder utility, such as the [`qs`](https://github.com/ljharb/qs) library available in your project.

## Fetch user profiles

The Advanced Personalization API exposes an [endpoint to retrieve user profiles](/doc/rest-api/advanced-personalization/get-users) based on specified parameters.

Here's a function to communicate with this endpoint:

```js JavaScript theme={"system"}
import qs from 'qs';

export async function fetchUserProfiles(params) {
  const { appId, apiKey, region, ...usersParams } = params;
  const response = await fetch(
    `https://ai-personalization.${region}.algolia.com/2/users${qs.stringify(
      usersParams,
      { addQueryPrefix: true }
    )}`,
    {
      headers: {
        'X-Algolia-Application-Id': appId,
        'X-Algolia-API-Key': apiKey,
      },
    }
  );

  if (!response.ok) {
    const errorMessage = await response.text();
    throw new Error(errorMessage);
  }

  const json = await response.json();

  return json;
}
```

The function takes as parameters an object containing:

* `appId`: your Algolia <ApplicationID />
* `apiKey`: your Algolia search <APIKey />, with `search`, `browse`, and `recommendation` ACLs
* `region`: the Algolia region (for example, `"us"`, `"eu"`)
* [Additional parameters for retrieving user profiles](/doc/rest-api/advanced-personalization/get-users)

## Browse user profiles

To iterate through all user profiles and handle pagination automatically, use this function:

```js JavaScript theme={"system"}
export async function browseUserProfiles(callback, params) {
  let nextPageToken = '';
  do {
    const response = await fetchUserProfiles({
      ...params,
      nextPageToken,
    });
    nextPageToken = response.nextPageToken;

    await callback(response.users);
  } while (nextPageToken);
}
```

## Process batches of user profiles

Here's an example of how to process batches of user profiles:

```js JavaScript theme={"system"}
async function processUsers(users) {
  // Perform operations with all users in the batch
}

await browseUserProfiles(processUsers, {
  appId: 'ALGOLIA_APPLICATION_ID',
  apiKey: 'ALGOLIA_SEARCH_API_KEY',
  region: 'us',
  affinity: 'category:camping',
  limit: 100
});
```

Segment users based on their `category:camping` affinity and implement targeted strategies for these users.
For example, send them an email about a discount on camping products.

Find the list of available parameters in the [REST API documentation](/doc/rest-api/advanced-personalization/get-users).