Facebook Public Data API
Collect public Facebook Page profiles, posts, and comments with normalized identity, content, author, media, reaction, and engagement fields through one API workflow.
Available Facebook APIs
Use Pages for public profile fields, Posts for public content, and Comments for public discussion records. All three 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.
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.
| Capability | SocQ | Facebook Graph API |
|---|---|---|
| Primary use | Public Page, post and comment data collection | Manage authorized Pages, apps and assets |
| Customer OAuth | SocQ API key; no customer Facebook OAuth | Meta app review, permissions and access tokens |
| Create or edit posts | Not supported | Supported with eligible Page permissions |
| Private or restricted data | Not supported | Only data granted through authorized permissions |
| Response format | Normalized SocQ records | Native 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. Submit public URLs
POST one or more supported public Page, profile, group or post URLs with an optional results limit.
2. Poll the task
Use the returned task ID until processing succeeds or fails. Back off after temporary pressure responses.
3. Read and paginate
Fetch normalized result items and follow next_cursor when the task contains more records.
Authenticate with a SocQ API key. This example starts a public Facebook Page task; use /v1/facebook/posts for posts and /v1/facebook/comments for comments.
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=50Common 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.
Reporting pipelines
Send normalized public Page and post records into dashboards, warehouses and internal review tools.
Limits and public-data policy
Facebook public results are dynamic. A field that is visible for one Page or post may be absent for another 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.
- 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.