Instagram user API for AI assistants

The Instagram user API takes an Instagram username or numeric user ID and returns account details: the handle, the numeric ID, story highlights, and reposted content. The reply is JSON, so your assistant reads the fields directly.

What it does

You pass the username or user ID, and the provider returns what it has on that account. Some endpoints return highlights, others return reposts, and others convert between username and numeric ID. Each endpoint answers a different question about the same account.

The API reads public accounts only. It does not log in, send follows, or see anything that Instagram hides from logged-out visitors.

How a Joshu assistant uses it

When you ask Joshu to check an Instagram account before a partnership meeting, it pulls the handle and highlights, then names the active highlight topics in the meeting note.

When you give Joshu a list of creator IDs from a spreadsheet, it looks up each username and adds it as a column next to the ID, so the list is readable.

When someone reposts your post, Joshu can track the account that reposted it and log it in a shared note with the other accounts that reshared your content that week.

Choosing a provider

Most jobs need the username or ID only, so start with the cheapest endpoint. Pick an endpoint that returns highlights when you need to know what the account keeps pinned, and pick one that returns reposts when you need to track who reshared content from someone else.

Providers differ in which fields they return and in how they name those fields.

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "anyapi.instagram.user_highlights",
    "params": {
      "handle": "username"
    }
  }'