Looker Studio Connector

The Fanpage Karma Looker Studio Connector brings your social media analytics data directly into Google Looker Studio. Build custom dashboards, combine data from multiple profiles, and visualize trends — all powered by the Fanpage Karma Data API v2.

What You Can Do

Profile Daily: Track daily follower growth, engagement rates, reach, and more over time.
Profile Metrics: Display aggregated KPIs like total followers, average engagement, impressions.
Posts: Analyze individual post performance with all available metrics.
Stories: Review Instagram Story reach, impressions, and interactions.
Multi-Profile: Compare multiple profiles side by side in a single dashboard.

Supported Networks

Facebook
Instagram
YouTube
LinkedIn
TikTok
Threads
Bluesky
Pinterest

Quickstart

Get your first Looker Studio dashboard running in under 5 minutes.

Get Your API Token

Log in to Fanpage Karma and go to Settings → API. Copy your API token — you will need it in the next step.
Open the Connector

Click the button below to add Fanpage Karma as a data source in Looker Studio:

Open in Looker Studio

You will be redirected to Looker Studio. Sign in with your Google account if prompted.
Authorize the Connector

Looker Studio will ask you to authorize the connector. Click “Authorize” to allow Fanpage Karma to fetch data on your behalf. Then paste your API token and click “Add”.
Configure Your Data Source

Select the following options:
- Network — Choose the social network (e.g., Facebook, Instagram).
- Profile ID(s) — Enter the profile ID from Fanpage Karma. You can find it in the profile URL or settings.
- Data Type — Select what data to import (Profile Daily, Profile, Posts, or Stories).
- Metrics (optional) — Limit the imported metrics to specific keys (e.g., fans_count,engagement).
Connect & Build Your Dashboard

Click “Connect” in the top right corner. You will see the list of available fields. Click “Create Report” (or “Explore”) to start building your dashboard.

Drag fields onto the canvas to create charts, tables, scorecards, and more.

Configuration Options

Field	Required	Description
Network	Yes	The social network to pull data from. Changing the network updates the available Data Types.
Profile ID(s)	Yes	One or more Profile IDs from Fanpage Karma. For multiple profiles, separate with commas: `6815841748,10206720`. Find the Profile ID in the profile URL on Fanpage Karma.
Data Type	Yes	The type of data to retrieve. Options depend on the selected network. See Data Types below for details.
Metrics	No	Comma-separated list of metric keys to include (e.g., `fans_count,engagement`). If left empty, all available metrics are imported. Useful to reduce clutter in the field list.

Data Types

Profile Daily Daily Metrics

Returns one row per day with daily values for each metric. Ideal for line charts, area charts, and trend analysis.

Dimensions: Profile ID, Date, Last Updated
Metrics: All available KPIs (fans count, engagement, reach, impressions, etc.)

Tip: Use the Metrics filter to request only the metrics you need. This keeps the schema clean and charts easier to configure.

Profile Aggregated Metrics

Returns a single row per profile with aggregated values across the selected date range. Ideal for scorecards, summary tables, and KPI overviews.

Dimensions: Profile ID, Last Updated
Metrics: All available KPIs (aggregated over the date range)

Posts Individual Posts

Returns one row per post with metadata and engagement metrics. Ideal for post-level tables, top-post rankings, and content analysis.

Dimensions: Profile ID, Date, Post ID, Message, Link, Image, Type, Last Updated
Metrics: All available post-level KPIs (likes, comments, shares, reach, etc.)

Supports automatic pagination — all posts in the date range are fetched.

Stories Instagram Stories

Returns one row per Instagram Story with metrics. Only available when Instagram is selected as network.

Dimensions: Profile ID, Date, Post ID, Message, Link, Image, Type, Last Updated
Metrics: Reach, impressions, interactions, etc.

Networks & Available Data Types

The available Data Types depend on the selected network:

Network	Profile Daily	Profile	Posts	Stories
Facebook	Yes	Yes	Yes	—
Instagram	Yes	Yes	Yes	Yes
YouTube	Yes	Yes	Yes	—
LinkedIn	Yes	Yes	Yes	—
TikTok	Yes	Yes	Yes	—
Pinterest	Yes	Yes	Yes	—
Threads	Yes	Yes	Yes	—
Bluesky	Yes	Yes	Yes	—
X	Yes	Yes	Yes	—

Multi-Profile Dashboards

You can compare multiple profiles in a single data source by entering comma-separated Profile IDs. Each profile's data is fetched and cached independently, and the Profile ID dimension lets you filter or group charts by profile.

Setup

Step 1: Enter Multiple Profile IDs

In the connector configuration, enter your Profile IDs separated by commas:
6815841748,10206720,UCdn86UYrf54lXfVli9CB6Aw

Step 2: Use the Profile ID Dimension

Add the Profile ID field as a dimension in your charts. This allows you to:
• Create separate chart series per profile
• Add a filter control so viewers can select specific profiles
• Build comparison tables with metrics side by side

Example: Comparing Follower Trends

Create a time series chart with:

Date as dimension
Follower count as metric
Profile ID as breakdown dimension

This creates one line per profile, making it easy to compare growth across accounts.

Note: All profiles must be on the same network. To compare profiles across different networks, create separate data sources.

Tips & Best Practices

Tip Use the Metrics Filter

If you only need a few metrics (e.g., followers and engagement), specify them in the Metrics configuration field. This reduces the number of fields in Looker Studio and makes it easier to find what you need.

Tip One Data Source per Data Type

Create separate data sources for Profile Daily, Profile, and Posts. Each data type has a different schema, so mixing them in one data source is not possible. You can combine multiple data sources on the same dashboard page.

Tip Use Date Range Controls

Add a Date range control to your dashboard so viewers can adjust the time period. The connector passes Looker Studio's date range directly to the API.

Tip Data Freshness

Data is cached for 15 minutes to keep your dashboard responsive. The Last Updated dimension shows exactly when the data was last fetched from the API. You can also manually refresh via View → Refresh data in the report menu.

Tip Discover Available Metrics

Not sure which metric keys are available? Use the API metrics catalog endpoint:
GET /api/v2/{network}/{endpoint}/metrics
Or check the API Documentation for a full list per network.

Demo Profiles

Try the connector without an API token using these public demo profiles. Simply enter the Profile ID in the configuration — no authentication needed.

Network	Profile	Profile ID
Facebook	Barack Obama	`6815841748`
Instagram	National Geographic	`10206720`
YouTube	Volvo Trucks	`UCdn86UYrf54lXfVli9CB6Aw`

Troubleshooting

“Your API token is invalid or expired”

Go to Settings → API in Fanpage Karma and copy a fresh token. Then revoke and re-authorize the connector in Looker Studio (Data source → Edit connection → Credentials → Revoke).

“This data type is not available for the selected network”

The Stories data type is only available for Instagram. Check the Networks table to see which data types are supported per network.

“Rate limit exceeded”

The API allows a limited number of requests per hour. Wait a few minutes and the data will refresh automatically. Consider using the Metrics filter to reduce the number of API calls.

“No Profile ID was provided”

Make sure you entered a Profile ID in the connector configuration. You can find the Profile ID in the Fanpage Karma profile URL or via the API endpoint GET /api/v2/profiles/connected.

“You have reached the profile access limit”

Your Fanpage Karma plan limits the number of profiles you can query via the API. Upgrade your plan or reduce the number of profiles in your data sources.

Data looks outdated

The connector caches data for 15 minutes. Use the Last Updated field to check when data was last fetched. Force a refresh via View → Refresh data in Looker Studio.