# Audience recommendations

> Current Froomle documentation · [View canonical page](https://docs.froomle.com/froomle-doc-main/v2/guide/topics/audience-recommendations.html)

> **WARNING:**
> 
> 🚧 This page is under construction. Content may be incomplete or subject to change.

<a id="_audience_selection"></a>

## Audience selection

Audience selection returns users ranked for a campaign. Use `offset` and `limit` to page through results. The same retrieval can be done in batches for large audiences.

Audience requests are synchronous and include:

-   `promotion.id` (one or more items or promotions)
    
-   `audience_size` (how many users to rank)
    
-   `limit` (batch size for retrieval)
    
-   `integration_type` (for example `email` or `push_notification_app`)
    
-   Optional `audience_id` (to track the campaign)
    

To retrieve an audience in batches, call the audiences endpoint with `audience_id`, `offset`, and `limit`.

Audience selection is complementary to batch recommendations: batch recommendations personalize content for a fixed list of users, while audience selection finds the best users for a fixed promotion.

Getting started:

-   Audience Targeting API must be activated by Froomle.
    
-   Use the API UI to test once credentials are issued.