Skip to content

Facebook reporting for agencies

Kanvro connects to your client's Facebook Page using the Meta Graph API (v25.0). Daily snapshot of reach, engagement, video views, follower growth, and post-level performance lined up against signups in your client's user database.

Facebook post performance table in Kanvro sorted by signup impact

What we pull

  • Page reach (organic + viral) — daily snapshot
  • Page impressions and unique impressions
  • Post-level reach, engagement, reactions, comments, shares
  • Video views (3-second and 30-second)
  • Follower count, daily growth, demographic breakdown (where Meta exposes it)
  • Live post comments via the dashboard's Post Comments modal

OAuth scopes we request

  • pages_show_list
  • pages_read_engagement
  • pages_read_user_content
  • read_insights
  • ads_read (only when an ad account is connected)

No write scopes. We never post on your behalf, never message anyone, never modify your settings.

Sync frequency

Every day at 06:00 SAST. Backfill runs once per client when the Page is first connected — backfill window depends on tier (30 days on Spark, 90 days on Ignite, 12 months on Amplify, unlimited on Command). Tokens auto-refresh via long-lived Page tokens; if a token expires, the dashboard surfaces a re-connect prompt.

What we don't include

  • Posting, scheduling, or replying to comments — Kanvro is read-only by design.
  • Ad creative or campaign management. Connected ad accounts surface read-only spend and performance only.
  • Messenger / inbox integration — Kanvro does not read DMs.
  • Audience custom audiences or remarketing pixels.

Notes

  • Meta's Graph API v25.0 is the version used. We update the version constant centrally — see `META_API_VERSION` in `functions/src/config/constants.ts`.
  • Meta App Review is required for the four `pages_*` and `read_insights` scopes. Kanvro's Meta app is in active review for these.
  • Compliance webhooks (`metaDeauthorize`, `metaDataDeletion`) are wired and processed within 30 days as POPIA + Meta require.

FAQ

Can I connect more than one Facebook Page per client?
One Page per client connection on the current tiering. If a client runs multiple brands as separate Pages, treat each brand as a separate client in Kanvro.
What about Facebook Groups?
Not currently supported — Meta restricts third-party Group analytics. We may add it later if Meta opens the API.
How fresh is the data?
Page metrics are pulled daily at 06:00 SAST. Post comments are fetched live on demand when you open the Post Comments modal in the dashboard.
What happens if I disconnect?
Use the Disconnect button in client settings. Kanvro purges tokens immediately, stops syncing, and retains historical metrics for 90 days for re-connect convenience. After 90 days they're deleted unless you've explicitly exported them on Command.

Connect Facebook in under 5 minutes.

Start free with Spark on your own brand, or book a 15-minute walkthrough.

Start Free with Spark