Back to APIs
Facebook public data

Facebook Public Data API

Collect public Facebook Page profiles, posts, group posts, comments, keyword-matched events, and available video transcripts with normalized identity, content, source, format, place, media, reaction, attendance, and engagement fields.

Available Facebook APIs

Use Pages for public profile fields, Posts for general content, Group Posts for group URL records, Comments for discussions, Events Search for keyword-matched events, and Video Transcripts for available spoken text from known video post or Reel URLs. All six use the same authentication and task-result pattern.

What Facebook data can you retrieve?

SocQ turns supported public Facebook results into consistent JSON records for enrichment, monitoring, research and reporting workflows.

Public Page profiles

Collect Page names, categories, descriptions, canonical URLs, profile images and cover images when publicly available.

Contact and audience fields

Return public websites, email addresses, phone numbers, locations, follower counts, Page likes, ratings and review counts when exposed.

Public post content

Collect post text, authors, timestamps, links, images, video references and normalized post identifiers.

Public comments and engagement

Collect public comment text, author fields, timestamps, likes, reply counts, shares, and reaction signals when available.

Public event discovery

Search by keyword for event names, schedules, places, attendance signals, cover images, and online or past-event status.

Available video transcripts

Extract source-linked transcript text and its plaintext or WebVTT format from known public video post or Reel URLs.

SocQ vs Facebook Graph API

SocQ focuses on supported public-data collection. Meta's Graph API is the correct choice for managing assets that a user or business has explicitly authorized.

CapabilitySocQFacebook Graph API
Primary usePublic Page, post, group post, comment, event, and transcript data collectionManage authorized Pages, apps and assets
Customer OAuthSocQ API key; no customer Facebook OAuthMeta app review, permissions and access tokens
Create or edit postsNot supportedSupported with eligible Page permissions
Private or restricted dataNot supportedOnly data granted through authorized permissions
Response formatNormalized SocQ recordsNative Graph API objects

How the Facebook API works

Collection runs asynchronously so your application can submit work, monitor its status and process result pages independently.

  1. 1. Submit an input

    POST supported public Page, post, group, video post, or Reel URLs, or submit a keyword query for event search, using the selected endpoint's documented fields.

  2. 2. Poll the task

    Use the returned task ID until processing succeeds or fails. Back off after temporary pressure responses.

  3. 3. Read and paginate

    Fetch normalized result items and follow next_cursor when the task contains more records.

Start with one API request

Authenticate with a SocQ API key. This example starts a public Facebook Page task; use /v1/facebook/posts for general posts, /v1/facebook/group-posts for group posts, /v1/facebook/comments for comments, /v1/facebook/events-search for event discovery, or /v1/facebook/video-transcript for known video post and Reel URLs.

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Common Facebook API use cases

Brand monitoring

Track public Page identity, contact, audience and post signals for owned brands or competitors.

Content and response research

Analyze public posts, comment text, authors, timestamps, media, and visible engagement for reporting or editorial research.

Page enrichment

Add public Facebook identity, category, contact and audience fields to CRM, directory or account records.

Event discovery and monitoring

Use keyword-matched event identity, schedule, place, attendance, cover, and status fields to organize public event records.

Reporting pipelines

Send normalized public Page and post records into dashboards, warehouses and internal review tools.

Spoken-content indexing

Index available transcript text with its source URL and format for selected public video posts and Reels.

Limits and public-data policy

Facebook public results are dynamic. A field that is visible for one Page, post, comment, event, or transcript source may be absent from another record or change over time.

  • Private groups, restricted profiles, removed posts and login-only content are not supported.
  • Public records may omit contact fields, comment authors, media, counters, timestamps, replies, or reaction breakdowns.
  • A submitted public video URL produces no transcript record when non-empty transcript text is unavailable.
  • Use smaller batches, conservative request rates and backoff after temporary blocks or rate pressure.
  • These endpoints do not create, update, moderate or delete Facebook content.

Facebook API frequently asked questions

Is this the official Facebook Graph API?

No. SocQ normalizes supported public Facebook results. Use Meta's Graph API for authorized Page management, publishing and moderation.

Do users need to connect Facebook accounts?

No customer Facebook OAuth is required for the supported public-data endpoints. Requests authenticate with a SocQ API key.

Can SocQ collect private groups or profiles?

No. Private, restricted and login-only Facebook content is outside the supported boundary.

How is usage priced?

Each endpoint card shows its current per-result credit price. Tasks are billed from the normalized records they return.

Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.