PlaygroundEndpointsFacebook APIFacebook Pages APIFacebook Groups APIInstagram APIAds Library APISocial Media APIPricingFAQ
REST API for social data

One social media API for Facebook, Instagram and the Meta ads library.

Read public profiles, pages, groups, posts, comments and every ad in the ads library over a single REST endpoint. No cookies, no proxies and no browser farm to run.

See pricing
  • No cookies or logged in sessions
  • One key across every platform
  • Cancel anytime
api.socialmediaapi.lol200 OK
curl -G "https://api.socialmediaapi.lol/v1/instagram/profile" \
  -H "Authorization: Bearer $SOCIALMEDIAAPI_KEY" \
  -d "username=nasa"

{
  "status": "ok",
  "data": {
    "username": "nasa",
    "followers": 97234118,
    "engagement_rate": 0.0412
  },
  "credits_used": 1
}
12.4Brequests served in the last year
38,000+developers building on the API
99.95%rolling 12 month uptime
380msmedian response time
Playground

Try any endpoint before you write a line of code.

Pick an endpoint, set the parameters and run it. Sign in with Google to unlock the playground, and your subscription decides whether you land here or on pricing.

GET https://api.socialmediaapi.lol/v1/facebook/profile?handle=zuck&fields=about%2CfollowersJSON

Public profile fields for any handle: bio, follower count, work history and verified status.

Sign in with Google to unlock the playground. Accounts without an active plan are sent to pricing, where every plan includes the full sandbox and a live API key.

sandbox response200 OK
Response bodynot sent yet
{
  "status": "idle",
  "message": "Run the request to see the response shape returned by this endpoint.",
  "endpoint": "/v1/facebook/profile"
}
  • Read-only access. We never post, like or follow on your behalf.
  • Credit based pricing, so one page of data costs one credit.
  • Public data only, sourced from the platforms own public surfaces.
Endpoints

Every endpoint you need, in four families

Profiles, pages, groups, posts, comments and ads. The same auth header and the same response envelope across all of them.

Facebook API

Details

Public profiles, pages, posts, comments and reactions, normalized into one envelope.

GET/v1/facebook/profile

Public name, about text, follower count, work history and verification.

  • followers
  • about
  • verified
GET/v1/facebook/page

Page metadata plus the newest feed items, reactions and comment counts.

  • feed
  • likes
  • talking_about
GET/v1/facebook/posts

Search public posts by keyword, page, author or date range.

  • query
  • since
  • until
GET/v1/facebook/comments

Every public comment on a post, with authors and parent replies.

  • post_id
  • replies
  • authors

Instagram API

Details

Profiles, posts, reels, hashtags and engagement metrics for public accounts.

GET/v1/instagram/profile

Follower counts, bio links, business category and engagement rate.

  • followers
  • category
  • engagement_rate
GET/v1/instagram/posts

Captions, hashtags, media URLs and per post metrics for a feed.

  • caption
  • likes
  • hashtags
GET/v1/instagram/hashtag

Top and recent media for any hashtag, with reach estimates.

  • top_media
  • recent_media
GET/v1/instagram/comments

Comment threads with authors, timestamps and reply structure.

  • comments
  • authors

Facebook Groups API

Details

Read public group posts and comments by slug or keyword, without joining.

GET/v1/facebook/group

Member count, privacy, rules and posting cadence for a public group.

  • members
  • privacy
  • rules
GET/v1/facebook/group/posts

Recent posts sorted by recency or engagement, pageable to the last year.

  • sort
  • limit
  • next_cursor
GET/v1/facebook/group/comments

Comment trees for any public group post, authors included.

  • post_id
  • replies
GET/v1/facebook/group/search

Find groups by keyword, country, size band and activity level.

  • query
  • country
  • size

Facebook Ads Library API

Details

Every ad in the Meta ads library, with creatives, advertisers and spend signals.

GET/v1/facebook/ads/search

Search the ads library by advertiser, keyword, country or date range.

  • query
  • country
  • active
GET/v1/facebook/ads/advertiser

Every ad a page is running, grouped by campaign and creative variant.

  • page_id
  • creatives
GET/v1/facebook/ads/creative

Copy, call to action, landing page, media and first seen date.

  • copy
  • cta
  • landing_page
GET/v1/facebook/ads/insights

Estimated spend bands, reach ranges and platform placement mix.

  • spend
  • reach
  • placements
Code examples

Three lines to your first response.

Send an API key, get JSON back. No OAuth dance, no browser automation and no session to keep warm.

  • Bearer token auth, one header for every endpoint
  • Cursor pagination on every list response
  • Errors carry a machine readable code and a retry hint
  • Sandbox and live modes share the same contract
curl -G "https://api.socialmediaapi.lol/v1/facebook/profile" \
  -H "Authorization: Bearer $SOCIALMEDIAAPI_KEY" \
  -d "handle=zuck" \
  -d "fields=about%2Cfollowers"
Why socialmediaapi.lol

Built for teams that ship data products

Everything between you and the public data you need, handled.

One key, every platform

Facebook, Instagram, Groups and the Ads Library sit behind the same auth header and the same response envelope.

Normalized JSON

Field names stay identical across endpoints, so one parser handles every platform you pull from.

No scraping stack

No cookies, no proxy pools, no browser farm to babysit. Rotation, retries and back off are handled for you.

Credit based pricing

Pay for the pages of data you actually pull instead of seats. Unused credits roll over on annual plans.

Built for volume

Burst to 500 requests per second on every plan, with a stable p95 and no surprise rate limits.

Versioned endpoints

Pin an API version, get a deprecation window in advance and subscribe to the changelog.

How it works

From sign up to first request in minutes.

1. Create your account

Sign in with Google. No card and no sales call before you can try the playground.

2. Generate an API key

One key works across every endpoint, with per key usage and spend limits you control.

3. Ship it

Call the REST endpoints, or paste the snippet for cURL, JavaScript or Python straight into your app.

FAQ

Questions developers actually ask

No. socialmediaapi.lol reads public data only, so you never connect a personal account, share a password or keep a logged in session alive.

Start building with social data today.

Create an account, generate a key and make your first request in the next five minutes.

Compare plans
  • Public data only
  • Cancel anytime
  • Human support

Ship notes, once a month

New endpoints, platform changes and deprecation windows. No marketing filler.

One email a month. Unsubscribe with a single click.

Social Media API - Facebook, Instagram, Groups and Ads Data