---
title: "One Facebook page by its id: its role, followers, Instagram, live and total ads and promo codes as the public brand it is linked to serves them (brands.facebookPages), with every brand it is linked to. The brand is its primary link, else the one it runs the most ads for. 404 when no public brand links the page."
method: GET
path: "/v1/facebook-pages/{pageId}"
tags: ["brands"]
---

# One Facebook page by its id: its role, followers, Instagram, live and total ads and promo codes as the public brand it is linked to serves them (brands.facebookPages), with every brand it is linked to. The brand is its primary link, else the one it runs the most ads for. 404 when no public brand links the page.

`GET /v1/facebook-pages/{pageId}`

## Request

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

One Facebook page by its id: its role, followers, Instagram, live and total ads and promo codes as the public brand it is linked to serves them (brands.facebookPages), with every brand it is linked to. The brand is its primary link, else the one it runs the most ads for. 404 when no public brand links the page. Scope `brands:read`; cache `daily`.

## Path parameters

- `pageId` string, required

## 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
    - `brand` object, required
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `logo_url` string, uri, nullable, required
      - `url` string, uri, required
    - `brands` object[], required
      - `id` string, uuid, required
      - `slug` string, required
      - `name` string, required
      - `logo_url` string, uri, nullable, required
      - `url` string, uri, 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)