Instagram Profiles
Instagram Profiles are public account pages with usernames, display names, biographies, profile images, external links, account categories, verification and privacy signals, and visible follower, following, and post counts. These identity, classification, and audience signals support profile enrichment, account comparison, directory maintenance, and point-in-time monitoring.
Features
- Known username lookupResolve one or more supplied public usernames and emit at most one normalized profile record for each account found.
- Identity and profile linksReturn account ID, username, display name, canonical profile URL, profile image, biography, external URL, and public biography links.
- Account classification and statusRetain visible verification and privacy status together with public category, business-account, and professional-account signals.
- Visible profile countsGroup follower, following, and post counts under metrics and timestamp the normalized record with collected_at.
Parameters
| Parameters | Required | Description |
|---|---|---|
usernames | Required | Required non-empty list of public Instagram usernames. A leading @ is accepted and removed before lookup. |
How to Use
Submit known usernames as an asynchronous task, poll its task ID, and read the resolved public profile records with cursor pagination.
- Prepare a non-empty usernames array containing the public accounts you already know.
- POST the usernames array to /v1/instagram/profiles and save the returned task_id.
- Poll /v1/tasks/{task_id} until status becomes succeeded or failed.
- Read data.results.items after success and pass results.next_cursor when results.has_more is true.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram","@natgeo"]}'
# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is trueBest Use Cases
- Known-account enrichment: Add stable IDs, display names, biographies, profile images, canonical URLs, and public links to records that already contain Instagram usernames.
- Selected account comparison: Compare visible verification, category, account-type signals, and follower, following, and post counts across a defined username cohort.
- Profile snapshot monitoring: Store collected_at with visible account counts from repeated collections to compare point-in-time profile records.
Pro Tips
- Submit usernames rather than profile URLs or search phrases because this endpoint accepts only the usernames array.
- Strip leading @ characters and deduplicate the resulting handles before submission so name and @name do not trigger separate lookups.
- Reconcile returned usernames against the input list because an unavailable, renamed, or inaccessible account can produce no profile record.
- Preserve missing counts and account flags as unknown values instead of converting them to zero or false.
- Store collected_at beside metrics when comparing repeated profile snapshots.
Related APIs
Use these APIs when you need a different type of public Instagram data.
- Instagram Followers Count API — Retrieve public profile identity and visible follower, following, and post counts.
- Instagram Posts API — Collect public posts, media, hashtags, mentions, timestamps, and engagement by username.
- Instagram Reels API — Collect public Reels, media, audio, hashtags, mentions, and engagement by username.
- Instagram Search API — Search public profiles by keyword or handle with identity and visible account signals.
- Instagram Comments API — Collect public comments, authors, timestamps, likes, and replies from post URLs.
- Instagram Followers List API — Collect public follower profile records with source-account and relationship context.
- Instagram Following List API — Collect public profiles followed by Instagram accounts with identity, relationship context, and visible account counts.
- Instagram Hashtag Posts API — Discover public posts by hashtag with source-tag context, media, creators, timestamps, and visible engagement.
- Instagram Tagged Posts API — Collect public posts that tag selected profiles with authors, media, mentions, tagged-user context, and engagement.
- Instagram Transcript API — Extract transcript text, language, format, source URLs, and shortcodes from public post or Reel URLs.
- Instagram Audio Reels API — Collect public Reels by known numeric audio ID with captions, creators, media, timestamps, visible engagement, and source-audio context.
- Instagram Highlight Items API — Retrieve saved public Story items from known highlight IDs with text, author identity, media, timestamps, visible metrics, and source context.
- Instagram Post Info API — Look up known public post, Reel, or legacy IGTV URLs with captions, author identity, media, timestamps, visible engagement, and input context.
- Instagram Reels Search API — Search public Reels by text query with captions, creators, media, timestamps, visible engagement, and query context.
- Instagram Story Highlights API — List public Story Highlight containers by username with titles, owner context, media counts, and reusable highlight IDs.
- Instagram Trending Reels API — Capture the current public Reel set from the trending feed with captions, creators, media, timestamps, and visible engagement.