Facebook Profiles
Facebook profiles and Pages are public identity surfaces with names, bio or about text, avatars, canonical links, and visible audience or activity counters. These identity fields and public signals support URL enrichment, entity matching, metadata snapshots, and comparative research.
Features
- Direct lookup for known URLsSubmit multiple public Facebook profile or Page URLs and receive at most one normalized profile record for each input.
- Normalized identity fieldsReturn the Facebook ID, canonical URL, display name, record type, and original input URL in a consistent structure.
- Public profile presentationCapture the public bio, intro, description, or about text together with the available profile or Page avatar.
- Visible profile countersNormalize common public follower, following, post, like, comment, view, play, and share counters exposed by the target.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required public Facebook profile or Page URLs. Accepted hosts are facebook.com, www.facebook.com, and m.facebook.com; separate multiple values with commas or new lines. |
How to Use
Submit profile or Page URLs as an asynchronous task, poll its task ID, then read the normalized profile records.
- Prepare one or more public profile or Page URLs on facebook.com, www.facebook.com, or m.facebook.com.
- POST urls to /v1/facebook/profiles.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read data.results.items from /v1/tasks/{task_id}?limit=50 and follow results.next_cursor while results.has_more is true.
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Best Use Cases
- Profile and Page catalog enrichment: Add normalized IDs, names, canonical links, bio text, avatars, and visible counters to a catalog of known Facebook URLs.
- Known-URL identity matching: Use returned IDs, canonical URLs, names, and extra.input_url to connect submitted links with existing entity records.
- Public metadata snapshots: Store collected_at with the available profile text, avatar, and counters to compare public metadata across collection runs.
Pro Tips
- Verify that each URL points to the intended profile or Page, because request validation checks the Facebook host but not the resource path.
- Keep extra.input_url when reconciling a multi-URL task, since duplicate or unavailable inputs can produce fewer records than submitted URLs.
- Treat names, profile text, avatars, and individual metric values as nullable because personal profiles and Pages expose different public fields.
- Use the corresponding Facebook content endpoint when you need posts, photos, Reels, events, or reviews rather than profile-level metadata.
Related APIs
Use these APIs when you need a different type of public Facebook data.
- Facebook Pages API — Retrieve public Page profiles, contact details, images, and visible audience ratings.
- Facebook Posts API — Collect public posts, media, reactions, comments, and shares from supported Facebook URLs.
- Facebook Comments API — Collect public comments, authors, engagement, media, and source links from post URLs.
- Facebook Video Transcript API — Extract available transcript text and format from known public video post or Reel URLs.
- Facebook Group Posts API — Collect public posts from Facebook group URLs with selectable ordering, per-group limits, author context, video media, and visible engagement.
- Facebook Events Search API — Search public events by keyword with schedule, place, attendance, cover media, and event-state fields.
- Facebook Ad Transcript API — Extract available spoken-word text, language, format, and source context from Facebook Ad Library URLs.
- Facebook Comment Replies API — Retrieve public replies for a known comment using its feedback ID and expansion token, with text, author identity, engagement, and parent context.
- Facebook Company Reviews API — Collect public Page reviews with review text, reviewer links, ratings, likes, timestamps, and company context.
- Facebook Event Details API — Collect normalized metadata, schedules, locations, media, and visible engagement from known public event URLs.
- Facebook Profile Events API — Collect public events associated with profile or Page URLs, including names, schedules, locations, media, visible metrics, and source context.
- Facebook Profile Photos API — Collect public photos from profile or Page URLs with captions, author context, engagement, image metadata, and source references.
- Facebook Reels API — Collect public Reels from profile or Page URLs with captions, author context, video metadata, visible engagement, and source references.
Combine Facebook data with public data from other supported social platforms.