---
title: "Get suggestions via POST"
method: POST
path: "/home/suggestions"
tags: ["Homepage"]
---

# Get suggestions via POST

`POST /home/suggestions`

Retrieves a paginated list of suggestions for the user, using a POST body for location filter criteria.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `products` string, nullable

## Request body

- object — Request body for filtering locations by various criteria
  - `locationIds` integer[], nullable — List of location IDs to include
  - `businessIds` integer[], nullable — List of business IDs to include
  - `locationGroupIds` integer[], nullable — List of location group IDs to include
  - `labels` string[], nullable — List of labels to include
  - `excludedLocationIds` integer[], nullable — List of location IDs to exclude
  - `excludedBusinessIds` integer[], nullable — List of business IDs to exclude
  - `excludedLocationGroupIds` integer[], nullable — List of location group IDs to exclude
  - `excludedLabels` string[], nullable — List of labels to exclude
  - `filterCategory` string, nullable — Filter strategy to apply: location-groups, labels, business, or location
  - `query` string, nullable — Search query string depending on filter category

## Response `200`

Successfully retrieved suggestions

- object — Paginated response containing actionable suggestions for improving location performance
  - `suggestions` object[], required — List of suggestions
    - `priority` 'HIGH' | 'MEDIUM' | 'LOW', required — Priority level of the suggestion
    - `product` string, required — Product area the suggestion relates to
    - `type` 'UPLOAD_VIDEO' | 'CONNECT_FACEBOOK_BUSINESS' | 'APPLE_BUSINESS_CONNECT' | 'ENABLE_MESSAGES' | 'ENABLE_FACEBOOK_MESSENGER' | 'ENABLE_CONTACT_FORM' | 'CONNECT_INSTAGRAM_BUSINESS' | 'CREATE_FIRST_LOCATOR' | 'ADD_CONTENT_COLLECTION' | 'ASSIGN_LABELS_TO_LOCATION' | 'CREATE_INSTAGRAM_REEL' | 'CREATE_FACEBOOK_CAROUSEL_POST' | 'ACTIVATE_CHATBOT' | 'CONFIGURE_LIVE_AGENT_AVAILABILITY' | 'ENABLE_WEBCHAT' | 'ADD_KNOWLEDGEBASE' | 'CREATE_SHOWCASE_FOR_ABC' | 'ENABLE_POSTING_REQUESTS' | 'ENABLE_REVIEW_REQUEST' | 'CREATE_USER_GROUP' | 'FILL_META_TAGS_FOR_LOCATOR' | 'ADD_CTA_TO_LOCATOR' | 'CREATE_SOCIAL_TEMPLATE' | 'INVITE_MORE_USERS' | 'ACTIVATE_TWO_FACETOR_AUTH', required — Type of suggestion
    - `link` string, required — Deep link URL to resolve the suggestion
  - `page` integer — Current page number
  - `pageSize` integer — Number of items per page
  - `size` integer — Number of items in the current page
  - `totalCount` integer — Total number of suggestions

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - missing or invalid user headers

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/revisions/ddc577c548ee/schema)