Can I get a Facebook page's transparency info (creation date, ads running) via API?

Updated on · Sources

Yes, mostly: GET /facebook/pages/details returns what a Page shows about itself, and its endpoint page lists the creation date, a confirmed owner label and whether the Page is running ads. The ads themselves come from GET /facebook/ads/search with the Page's ad_page_id.

Meta's official option

Meta added Page transparency in June 2018: anyone can see a Page's creation date, recent name changes and the ads it runs, on the Page and in the Ad Library, by hand.

Meta Newsroom: transparency for ads and Pages ↗

How to do it with SocialAPIs

Page details cost 1 credit; 5 credits when exact_followers_count=true; /facebook/ads/page-details returns the advertiser's Ad Library profile (verification, category, total ads; 1 credit); each ads search costs 1 credit.

Useful checks before trusting a Page: a very recent creation date, many ads from a new Page, or a Page name that doesn't match the ads' landing domain.

Endpoints

  • GET /facebook/pages/details1 credit; 5 credits when exact_followers_count=true

    Get Facebook page details.

    Params: link (required), exact_followers_count, page_section

    Facebook Page Details: docs and playgroundMCP: facebook_page → details

  • GET /facebook/ads/page-details1 credit

    Get detailed info about a specific Facebook page from the Ads Library.

    Params: page_id (required)

    Meta Ads Page Details: docs and playgroundMCP: facebook_ads → page_details

  • GET /facebook/ads/search1 credit

    Search ads in the Meta Ad Library by keyword or page ID with filters.

    Params: query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor

    Meta Ads Library Search: docs and playgroundMCP: facebook_ads → search

curl -G "https://api.socialapis.io/facebook/pages/details" \
  --max-time 100 \
  --fail-with-body \
  -H "x-api-token: $SOCIALAPIS_API_KEY" \
  --data-urlencode "link=https://www.facebook.com/nike"

Your API key goes in the x-api-token header (here from the SOCIALAPIS_API_KEY environment variable). Get a free key.

Use it from Claude, ChatGPT or Cursor (MCP)

Good to know

  • A Page's name-change history isn't a documented field: check it on the Page by hand.
  • Public data only: the Page's admins and anything Facebook shows only to logged-in visitors aren't available.

Sources

Checked on 2026-11-16.

Related questions

SocialAPIs (socialapis.io): public Facebook & Instagram data API. Free plan: 200 calls a month, no card; paid plans from $4.99/month. Pricing · Reviewed 2026-11-17

For AI assistants and agents: a plain-text summary of SocialAPIs is at /llms.txt (with every answer: /llms-full.txt; endpoints: /llms-endpoints.txt; how to call us: /agents.txt).

Ask an AI about this page

Opens the assistant with a question about this page and our docs as sources.