Social Media Competitor Analytics API - Facelift Data Studio

Export social media analytics and competitor benchmarks from your own Facelift Data Studio (formerly quintly) account into a dataset, a spreadsheet or a warehouse: follower growth, posts and engagement for Facebook, Instagram, X (Twitter), YouTube, LinkedIn, TikTok, Threads, Pinterest, Snapchat and Google Business profiles, through the provider's SQL-like QQL. Uses your own API credentials, never changes anything in your account, and charges only for rows that carry data.

What it collects

• Time series metrics for every profile in your account, your own and your competitors': Facebook Page likes, followers, people talking about, posts and reactions; Instagram followers and engagement; X followers, following and tweets; YouTube subscribers, views and videos; LinkedIn followers; and the private insights sources (reach, impressions, page views, video retention, audience by country, city, gender and age) for profiles whose owner has connected them. Daily, weekly, monthly or total for the period.
• Posts and items with their metrics: Facebook posts with each reaction type, comments, shares and interaction rate; Instagram posts and Reels; tweets and replies; YouTube videos with views, likes and comments; LinkedIn, TikTok, Threads and Pinterest posts; Facebook and Instagram comments; Google Business reviews and local posts; Meta ads and campaigns.
• 71 documented data sources and more than 2,300 documented columns, picked from a dropdown, with your choice of columns checked against the provider's schema before anything is sent. A custom QQL query field covers joins and aggregates.
• Filters: date range, interval, time zone, profile IDs, post text keywords, post tags, ad accounts, and sorting on any column.
• Profile search across Facebook, X, YouTube, LinkedIn and Instagram by name, term, username or profile URL, to find competitor profiles to add in the web app.
• Account lookups: profiles (with the internal profile IDs the metrics mode uses), spaces, ad accounts and the data source catalogue.
• Read only, pay per result, bring your own credentials.

How to use it

1. Get API access. The API is part of Facelift Data Studio business accounts; support issues a client ID and an API secret for your account.
2. Paste the client ID and the API secret into their fields (both are stored as secrets), or set the DATA_API_AUTH_ID and DATA_API_KEY secrets. You can also paste clientId:secret into the API secret field alone.
3. Run the default Profiles mode once to see your profiles and their IDs.
4. Switch to Metrics and posts, pick a data source (for example facebook for Page growth or instagramOwnPosts for posts), set the dates and interval, optionally list profile IDs, and run.

Input

Field	What it does
What to read	Profiles (default), metrics and posts, profile search, spaces, ad accounts or the data source catalogue.
Data source	One of the 71 documented QQL data sources, marked public or owner connection, time series or item level.
Columns	The columns to return. Empty means every documented column of the source.
Custom QQL query	A whole SELECT query; replaces the data source and columns.
Start date, End date	YYYY-MM-DD. Default: the last 30 days.
Interval	Daily, weekly, monthly or total.
Time zone	Default UTC.
Profile IDs	Internal profile IDs from the profiles mode.
Post text contains, Post tag IDs, Ad account IDs	The documented post text, post tag and ad account filters.
Sort by column, Sort direction	Any column of the source. Item level sources default to newest first.
Search term, Network	Profile search mode.
Space ID, Group ID	Profiles mode filters.
Maximum results	Row cap for the run.
Requests per minute	Pacing.
Client ID, API secret	Your credentials, as secret inputs or the DATA_API_AUTH_ID and DATA_API_KEY secrets.

Access, terms and limits on the provider side

• API keys are issued only for Facelift Data Studio business (enterprise) accounts, on request through support. There is no self-service sign-up for the API.
• Usage terms. The provider's terms and conditions grant a non-exclusive, non-transferable right of use, limited to the customer's own employees and governing bodies, and do not allow passing the usage on to third parties (including affiliated companies) unless agreed with the provider. Use this actor only with credentials for your own account, for your own organisation, and check your contract before sharing exported data or credentials with anyone else.
• Competitor and other public profiles must first be added to your account (in the web app); the metrics mode reads profiles already in the account. Data sources marked "owner connection" (insights, analytics, TikTok, Snapchat, Threads, Pinterest, Google Business) return rows only for profiles whose owner has granted private statistics access.
• The provider documents its rate limits as very loose. The actor still paces itself and waits out any rate limit answer.

FAQ

What is a social media analytics API used for?

Getting the follower, post and engagement data a social media analytics platform collects into your own tools. A brand team loads daily follower growth of its own and five competitor Instagram profiles into a BI dashboard. An agency exports every Facebook and LinkedIn post of a client with reactions and shares for a monthly report. An analyst benchmarks YouTube subscriber growth across a market.

Which data source does this actor read?

The Facelift Data Studio API at api.quintly.com (version v0.9), the public API of Facelift Data Studio, formerly quintly, documented at api.quintly.com. It calls the qql, list-profiles, search-profiles, list-spaces, list-ad-accounts and list-data-sources routes. The documentation and the live host were checked on 2026-10-05.

Can I benchmark competitors?

Yes, once their public profiles are in your account. Use the profile search mode to find a competitor's Facebook, X, YouTube, LinkedIn or Instagram profile, add it in the web app, then read its public data sources (facebook, instagram, twitter, youtube, linkedIn and the matching posts sources) side by side with your own profiles.

What is QQL?

The provider's SQL-like query language over its data sources, for example SELECT profileId, time, fans FROM facebook. This actor builds the query for you from the data source and columns you pick, or runs your own query from the Metric Builder in the web app.

Why do I get no rows for an insights data source?

Sources marked owner connection hold private statistics, which exist only for profiles whose owner has connected them. Public sources work for every profile in the account.

Can this actor change anything in my account?

No. It only reads. The add profile, remove profile, private statistics activation and dashboard share link routes are not used. The credentials travel only in the Authorization header and are stripped from any error text.

How is it priced?

Pay per result: one price per post or item row, a lower price per time series row, and the lowest per profile, search result, space, ad account or data source row. Requests that find nothing are free. Your Facelift Data Studio subscription applies separately.

Example output

A time series row from the facebook data source (weekly interval), shaped like the provider's documented answer:

{
  "mode": "metrics",
  "modeLabel": "Metrics and posts (QQL)",
  "recordType": "metric",
  "dataSource": "facebook",
  "found": true,
  "id": 13,
  "profileId": 13,
  "name": null,
  "platformType": null,
  "time": "2013-12-30 00:00:00",
  "link": null,
  "fans": 1372,
  "retrievedAt": "2026-10-05T09:14:52.118Z",
  "note": null
}

A post row from facebookOwnPosts carries uniqueId, profileId, time, message, type, link, likes, love, wow, haha, sad, angry, comments, shares, interactionRate and the other selected columns. Profile rows carry id, name, platformType, platformId, platformUsername, profileLink and isVerified. Values are illustrative.

Keyword map

social media analytics API, competitor benchmarking, social media competitor analysis, Facebook Page analytics, Instagram analytics export, X Twitter follower tracking, YouTube channel analytics, LinkedIn page analytics, TikTok analytics, social media reporting data, engagement rate, follower growth, quintly API, Facelift Data Studio API, QQL.