---
title: "Facebook pages linked to the brand with their servable role (quarantined links dropped, unservable claims as UNVERIFIED), followers and ad counts, most ads first."
method: GET
path: "/v1/brands/{brandId}/facebook-pages"
tags: ["brands"]
---

# Facebook pages linked to the brand with their servable role (quarantined links dropped, unservable claims as UNVERIFIED), followers and ad counts, most ads first.

`GET /v1/brands/{brandId}/facebook-pages`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/facebook-pages`
- Auth: HTTP bearer

Facebook pages linked to the brand with their servable role (quarantined links dropped, unservable claims as UNVERIFIED), followers and ad counts, most ads first. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Response `200`

Success.

- object
  - `data` object[], required
    - `page_id` string, required
    - `page_name` string, nullable, required
    - `role` 'OFFICIAL' | 'INFLUENCER' | 'CELEBRITY' | 'SHADOW' | 'SUB_BRAND' | 'MEDIA' | 'PROMOTER' | 'WHITELISTED' | 'AFFILIATE' | 'UNVERIFIED' | 'UNCLASSIFIED' | 'OTHER', required
    - `likely_role` 'OFFICIAL' | 'INFLUENCER' | 'CELEBRITY' | 'SHADOW' | 'SUB_BRAND' | 'MEDIA' | 'PROMOTER' | 'WHITELISTED' | 'AFFILIATE' | 'UNVERIFIED' | 'UNCLASSIFIED' | 'OTHER', nullable, required
    - `is_primary` boolean, nullable, required
    - `attribution_scope` string, required
    - `profile_picture` string, nullable, required
    - `instagram_handle` string, nullable, required
    - `instagram_followers` integer, nullable, required
    - `facebook_followers` integer, nullable, required
    - `active_ads` integer, nullable, required
    - `total_ads` integer, nullable, required
    - `first_ad_date` string, date, nullable, required
    - `last_ad_date` string, date, nullable, required
    - `promo_codes` object[], nullable, required
      - `code` string, required
      - `ads` integer, required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4d67a114a13c?raw)