Instagram API

Name: Instagram API
Brand: Instagram API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentSocial MediaSocial ManagementapiKey, oauth227 EndpointsREST

For Agents

Retrieve Instagram media, search by hashtag or location, manage user relationships, and moderate comments. Covers 27 endpoints for user content and social interactions.

Install Jentic One Beta

Connect the Instagram API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Instagram API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Instagram API.

Search for media by geographic coordinates within a radius or by hashtag

Retrieve a user's feed, liked media, and follower/following relationships

Fetch individual media objects with full metadata, comments, and like counts

GET STARTED

Start building with Instagram API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Instagram API for, with concrete tasks.

★ AI Agent Hashtag Monitoring

An AI agent tracks media posted with specific hashtags by calling /tags/{tag-name}/media/recent, analyzing engagement patterns and content volume over time. Through Jentic, the agent discovers the hashtag media endpoint by searching 'find instagram posts by hashtag', loads the schema with pagination parameters, and executes without manual API configuration. Returns media objects with like counts, comment counts, and user attribution.

Retrieve the 20 most recent media posts tagged with 'travel' via GET /tags/travel/media/recent and return each post's like count and comment count

Location-Based Media Discovery

Search for Instagram media posted near specific geographic coordinates using /media/search with lat and lng parameters, or find locations via /locations/search and then retrieve their recent media. Supports radius filtering in meters and returns media with full metadata including timestamps, captions, and engagement counts.

Search for media posted within 1000 meters of latitude 40.7128, longitude -74.0060 via GET /media/search?lat=40.7128&lng=-74.0060&distance=1000

User Profile and Relationship Analysis

Retrieve user profiles via /users/{user-id} including media count, follower count, and following count. Check relationship status between users with /users/{user-id}/relationship and retrieve follower/following lists for social graph analysis. Supports pagination for large follower lists.

Retrieve the profile for user-id 12345 via GET /users/12345 and then fetch their follower list via GET /users/12345/followed-by

Comment Moderation and Engagement

Monitor comments on media posts using GET /media/{media-id}/comments and remove inappropriate content with DELETE /media/{media-id}/comments/{comment-id}. Post replies and new comments via POST /media/{media-id}/comments. Enables automated moderation workflows for brand accounts managing high-volume comment sections.

Retrieve all comments on media-id 67890 via GET /media/67890/comments and delete comments containing blocked keywords via DELETE /media/67890/comments/{comment-id}

Key Endpoints

27 endpoints — query and interact with instagram content through 27 endpoints covering media, users, tags, locations, comments, and likes.

METHOD

PATH

DESCRIPTION

GET

/users/{user-id}

Retrieve a user's profile information

GET

/users/self/feed

Get the authenticated user's feed

GET

/media/search

Search for media by location

GET

/tags/{tag-name}/media/recent

Get recent media by hashtag

GET

/media/{media-id}/comments

List comments on a media item

POST

/media/{media-id}/comments

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Instagram OAuth tokens and API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped tokens with only the required permissions (basic, comments, relationships) — raw client IDs and secrets never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'search instagram posts by hashtag') and Jentic returns the matching GET /tags/{tag-name}/media/recent operation with its full parameter schema, so the agent can construct valid requests without reading Instagram's developer docs.

Time to first call

Direct Instagram API integration: 2-4 days for OAuth setup, scope configuration, and sandbox/live approval. Through Jentic: under 1 hour — search for the operation, load the schema, execute.

FAQs

Specific to using Instagram API through Jentic.

What authentication does the Instagram API use?

The Instagram API supports two authentication methods: OAuth 2.0 implicit flow for user-authorized requests (accessing feeds, posting comments) and an API key passed as an access_token query parameter for client-level access. The OAuth flow grants scopes like basic, comments, relationships, and likes. Through Jentic, these credentials are stored encrypted in the MAXsystem vault — agents receive scoped tokens without handling raw client secrets.

Can I search for Instagram media by hashtag?

Yes. Use GET /tags/{tag-name}/media/recent to retrieve the most recent media tagged with a specific hashtag. The response includes media objects with image URLs, captions, like counts, comment counts, and the posting user's information. Pagination is handled via the max_tag_id parameter for retrieving older results.

What are the rate limits for the Instagram API?

The Instagram API enforces a limit of 200 requests per hour per access token for sandbox mode applications. Approved live applications have higher limits that vary by endpoint. Rate limit information is returned in response headers (X-Ratelimit-Remaining, X-Ratelimit-Limit) with each API call.

How do I find media near a specific location through Jentic?

Install the Jentic SDK with pip install jentic, then search for 'search instagram media by location'. Jentic returns the GET /media/search operation with its schema showing required lat and lng parameters plus optional distance (default 1000m, max 5000m). Load the schema and execute with your coordinates. Sign up at https://app.jentic.com/sign-up.

Can I moderate comments on Instagram posts?

Yes. Retrieve comments with GET /media/{media-id}/comments, post new comments with POST /media/{media-id}/comments (requires comments scope), and delete your own comments with DELETE /media/{media-id}/comments/{comment-id}. The comments scope must be granted during OAuth authorization for write operations.

Does the Instagram API support posting new media?

This version of the Instagram API (v1) does not support uploading new photos or videos. It provides read access to media, comments, likes, and user data, plus write access for comments and likes. Media publishing requires the Instagram Graph API (accessed through the Facebook Graph API platform) with specific business account permissions.