Log inStart Free Trial
easyCoexistence Official APIs

Facebook Page followers count through the API: followers_count vs fan_count

A Facebook Page's follower count is the followers_count field: GET /{page-id}?fields=followers_count returns it. fan_count counts likes, and on Pages in the New Pages Experience Meta returns followers_count there too. For changes over time, the page_follows insights metric gives the follower total by day, replacing page_fans, which Meta deprecated on November 15, 2025.

easyCoexistence reads a Facebook Page's followers for Claude, ChatGPT or your own code: get_social_insights returns page_follows and unfollows by day.

followers_count

Page field that Meta's reference describes as the number of Page followers.

fan_count

The number of users who like the Page; for New Page Experience Pages, Meta returns followers_count in it.

15 Nov 2025

When page_fans, page_fan_adds and page_fan_removes stopped working in all versions; Meta names page_follows as the alternative to page_fans.

page_follows

Followers counted as follows minus unfollows over the Page's lifetime, read with period day.

page_daily_unfollows_unique

Accounts that unfollowed the Page in the period, by day, week or days_28; Meta marks it as estimated.

New Pages Experience

Where Meta says all classic Pages will be migrated; has_transitioned_to_new_page_experience shows whether a Page has moved.

Which field holds a Page's follower count?

followers_count, a field of the Page node that Meta's reference describes as the number of Page followers. GET /{page-id}?fields=followers_count, made with a Page access token, returns the current total. It carries no history, so read the page_follows metric for change over time, or store the field's value on a schedule.

Both counts on one Page
GET /{page-id}?fields=followers_count,fan_count

{
  "followers_count": <FOLLOWERS>,
  "fan_count": <LIKES, OR FOLLOWERS ON A NEW PAGES EXPERIENCE PAGE>,
  "id": "<PAGE_ID>"
}

What is the difference between followers_count and fan_count?

Follows against likes. Meta's Page reference describes followers_count as the number of Page followers and fan_count as the number of users who like the Page, adding that for New Page Experience Pages, fan_count returns followers_count, and that on a Global Page it covers all the Pages across the brand. Meta says all classic Pages will be migrated to the New Pages Experience, and has_transitioned_to_new_page_experience tells whether a Page has moved.

Which follower metrics did Meta deprecate, and when?

Meta moved Page Insights from likes, which its metrics called fans, to follows in several rounds. Each round applied to all API versions at once, and a retired name now returns an invalid metric error. The rounds that touch followers:

DeprecatedUse instead
Nov 15, 2025page_fanspage_follows
Nov 15, 2025page_fan_adds, page_fan_adds_uniqueNo alternative listed
Nov 15, 2025page_fan_removes, page_fan_removes_uniqueNo alternative listed
By Sep 16, 2024page_fans_by_like_source, page_fans_by_unlike_sourceNo alternative listed
By Sep 16, 2024page_daily_follows_by_source, page_daily_unfollows_by_sourceNo alternative listed
By Sep 16, 2024page_fans_online, page_fans_online_per_dayNo alternative listed

How do you read follower changes over time?

With page_follows and period set to day. Each daily value is the Page's follower total, counted as follows minus unfollows over its lifetime, so comparing two days gives the net change between them. page_daily_unfollows_unique adds the accounts that unfollowed, by day, week or days_28. since and until select up to 90 days per request, and the first end_time returned is the since date plus one day, so it includes the since date's data.

Followers and unfollows by day for October 2026
GET /{page-id}/insights?metric=page_follows,page_daily_unfollows_unique&period=day&since=2026-10-01&until=2026-10-31

{
  "data": [
    {
      "name": "page_follows",
      "period": "day",
      "values": [
        { "value": <FOLLOWERS>, "end_time": "2026-10-02T07:00:00+0000" },
        { "value": <FOLLOWERS>, "end_time": "2026-10-03T07:00:00+0000" }
      ]
    }
  ]
}

What about page_daily_follows?

Meta still lists page_daily_follows and page_daily_follows_unique in its insights reference, but describes both as Not defined, and marks the second as estimated. page_follows and page_daily_unfollows_unique are the follower metrics with a documented meaning, so reports that have to be explained are better built on those two.

Which permissions and tasks does reading followers need?

For a Page you manage, Meta's Page reference lists pages_read_engagement, pages_read_user_content and pages_show_list for the Page's own data, read with a Page access token. Insights such as page_follows add read_insights and a token from someone with the ANALYZE task. For Pages you do not manage, only public data is open, through the Page Public Content Access or Page Public Metadata Access features.

What thresholds apply?

Page Insights data is only available on Pages with 100 or more likes, and Meta keeps it for two years on public Pages and 5 days on unpublished ones. Metrics ending in _unique, such as page_daily_unfollows_unique, are approximate, and demographic breakdowns come back only with data for 100 or more people.

How does easyCoexistence read followers?

Through insights, from Claude, ChatGPT or your own code. get_social_insights reads page_follows and page_daily_unfollows_unique with a period, plus since and until through its params. The followers_count field of the Page itself has no tool, so the current total is read on the Page.

Common mistakes

  • Requesting page_fans. Meta deprecated it on November 15, 2025; ask for page_follows for the follower total.
  • Reading fan_count as a like count. On New Page Experience Pages Meta returns followers_count in it, so it does not separate likes from follows there.
  • Adding up daily page_follows values. Each one is a running total, so subtract one day's value from the next to get the change instead.
  • Waiting for page_fan_adds to come back under a new name. Meta listed no alternative for it or for page_fan_removes; page_daily_unfollows_unique covers unfollows only.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Is fan_count deprecated?

Meta's Page reference does not mark it deprecated, but on New Page Experience Pages it returns followers_count, so ask for followers_count directly.

What replaced page_fans?

page_follows, which counts the Page's followers as follows minus unfollows, once page_fans stopped working on November 15, 2025.

How far back can I read a Page's follower history?

Two years for a public Page, in requests of up to 90 days each with since and until.

How much does easyCoexistence cost for a Facebook Page?

Each Page is one connection, at US$ 9 to US$ 0.75 per connection per month depending on your total count, and the first 3 days are free.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on