# Socify API — Instagram endpoints # Base URL: https://trysocify.com # API host: https://api.trysocify.com # Auth: Authorization: Bearer # Full catalog: https://trysocify.com/llms-endpoints.txt | JSON: https://trysocify.com/llms.json # Agents map: https://trysocify.com/agents.txt | Index: https://trysocify.com/llms.txt # Docs hub: https://trysocify.com/docs/api/instagram | OpenAPI: https://trysocify.com/openapi.json 15 documented Instagram operations. Public Instagram profiles, posts, reels, and engagement data. Do not invent paths — only the routes below (and their linked markdown pages) are supported. ## GET /api/v1/instagram/profile Profile Fetch a public Instagram profile by username. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/profile.md HTML: https://trysocify.com/docs/api/instagram/profile SEO: https://trysocify.com/instagram/profile Parameters: - username (required, string) - Instagram username without @. Example: `natgeo`. curl: curl -sS "https://trysocify.com/api/v1/instagram/profile?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/posts Posts Fetch recent public posts for a profile. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/posts.md HTML: https://trysocify.com/docs/api/instagram/posts SEO: https://trysocify.com/instagram/posts Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/posts?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/comments Comments Fetch public comments for a post. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/comments.md HTML: https://trysocify.com/docs/api/instagram/comments SEO: https://trysocify.com/instagram/comments Parameters: - code (optional, string) - Exactly one of code, id, or url. Prefer shortcode. Example: `C-6WRvdS75Q`. - id (optional, string) - Numeric media id (alternative to code/url). Example: `3439159241662512720`. - url (optional, string) - Full Instagram post URL (alternative to code/id). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/comments?code=C-6WRvdS75Q" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/reels Reels Fetch recent reels for a profile. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/reels.md HTML: https://trysocify.com/docs/api/instagram/reels SEO: https://trysocify.com/instagram/reels Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/reels?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/hashtag Hashtag Fetch public metadata for an Instagram hashtag. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/hashtag.md HTML: https://trysocify.com/docs/api/instagram/hashtag SEO: https://trysocify.com/instagram/hashtag Parameters: - name (required, string) - Hashtag name without #. Example: `nature`. curl: curl -sS "https://trysocify.com/api/v1/instagram/hashtag?name=nature" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/hashtag-posts Hashtag Posts Fetch top public posts for a hashtag. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/hashtag-posts.md HTML: https://trysocify.com/docs/api/instagram/hashtag-posts SEO: https://trysocify.com/instagram/hashtag-posts Parameters: - name (required, string) - Hashtag name without #. Example: `nature`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/hashtag-posts?name=nature" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/followers Followers Fetch a page of followers for a profile. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/followers.md HTML: https://trysocify.com/docs/api/instagram/followers SEO: https://trysocify.com/instagram/followers Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/followers?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/following Following Fetch a page of accounts a profile follows. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/following.md HTML: https://trysocify.com/docs/api/instagram/following SEO: https://trysocify.com/instagram/following Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/following?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/post Post Fetch public details for a single post. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/post.md HTML: https://trysocify.com/docs/api/instagram/post SEO: https://trysocify.com/instagram/post Parameters: - code (optional, string) - Exactly one of code or url. Prefer shortcode. Example: `C-6WRvdS75Q`. - url (optional, string) - Full Instagram post URL (alternative to code). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`. curl: curl -sS "https://trysocify.com/api/v1/instagram/post?code=C-6WRvdS75Q" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/stories Stories Fetch current public stories for a profile. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/stories.md HTML: https://trysocify.com/docs/api/instagram/stories SEO: https://trysocify.com/instagram/stories Parameters: - username (required, string) - Instagram username without @. Example: `natgeo`. curl: curl -sS "https://trysocify.com/api/v1/instagram/stories?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/highlights Highlights Fetch story highlights for a profile. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/highlights.md HTML: https://trysocify.com/docs/api/instagram/highlights SEO: https://trysocify.com/instagram/highlights Parameters: - username (required, string) - Instagram username without @. Example: `natgeo`. curl: curl -sS "https://trysocify.com/api/v1/instagram/highlights?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/tagged Tagged Fetch public posts where a profile was tagged. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/tagged.md HTML: https://trysocify.com/docs/api/instagram/tagged SEO: https://trysocify.com/instagram/tagged Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/tagged?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/search Search Search public Instagram profiles by query. Returns a single page (not cursor-paginated). Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/search.md HTML: https://trysocify.com/docs/api/instagram/search SEO: https://trysocify.com/instagram/search Parameters: - query (required, string) - Search text. Example: `natgeo`. curl: curl -sS "https://trysocify.com/api/v1/instagram/search?query=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/likers Likers Fetch users who liked a post. Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/likers.md HTML: https://trysocify.com/docs/api/instagram/likers SEO: https://trysocify.com/instagram/likers Parameters: - code (optional, string) - Exactly one of code, id, or url. Prefer shortcode. Example: `C-6WRvdS75Q`. - id (optional, string) - Numeric media id (alternative to code/url). Example: `3439159241662512720`. - url (optional, string) - Full Instagram post URL (alternative to code/id). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`. - cursor (optional, string) - Pagination cursor from a previous response. curl: curl -sS "https://trysocify.com/api/v1/instagram/likers?code=C-6WRvdS75Q" \ -H "Authorization: Bearer $SOCIFY_KEY" ## GET /api/v1/instagram/related Related Fetch suggested/related profiles for a profile. Returns a single page (not cursor-paginated). Credit cost: 1 credit per request. Failed requests are free. Auth: Authorization: Bearer Docs: https://trysocify.com/docs/api/instagram/related.md HTML: https://trysocify.com/docs/api/instagram/related SEO: https://trysocify.com/instagram/related Parameters: - username (optional, string) - Exactly one of username or user_id. Prefer username. Example: `natgeo`. - user_id (optional, string) - Numeric user id (alternative to username). Example: `787132`. curl: curl -sS "https://trysocify.com/api/v1/instagram/related?username=natgeo" \ -H "Authorization: Bearer $SOCIFY_KEY"