Tutorials
Instagram profile in curl
One authenticated call to /api/v1/instagram/profile?handle=nasa, the response it returned, and the line that reads one field out of it.
What you need
curl ships with macOS and most Linux distributions, and with Windows 10 and later. There is nothing to install.
The call
curl -H "Authorization: Bearer $HH_KEY" \
"https://honesthook.com/api/v1/instagram/profile?handle=nasa"
What came back
{
"success": true,
"platform": "instagram",
"endpoint": "instagram/profile",
"data": {
"author": {
"id": "17841401474538262",
"handle": "nasa",
"name": "NASA",
"followers": 104357600,
"following": 91,
"posts_count": 4923,
"verified": true,
"is_private": false
}
},
"error": null,
"cached": true
}
Recorded response, captured 15 Sep 2026. A live call returns the value at the moment you ask, not this one.
Every field in that capture
| In curl | Type in this capture |
|---|
.success | boolean |
.platform | string |
.endpoint | string |
.data.author.id | string |
.data.author.handle | string |
.data.author.name | string |
.data.author.followers | number |
.data.author.following | number |
.data.author.posts_count | number |
.data.author.verified | boolean |
.data.author.is_private | boolean |
.error | null |
.cached | boolean |
A field we cannot read comes back null, never 0. A zero would be a claim about the account; null is a fact about our collection.
Reading one field
curl -H "Authorization: Bearer $HH_KEY" \
"https://honesthook.com/api/v1/instagram/profile?handle=nasa" \
| jq -r '.data.author.followers'
jq is a separate tool — it is not part of curl. Without it the command above prints the whole envelope, which is the block below.
Instagram's own API asks for a login and an app review before it tells you how many followers a public account has. This endpoint does not: you send one authenticated GET, and you get the eight normalised fields back in the same envelope every other platform here returns.
What you are calling
You are calling our endpoint, not Instagram's. The request goes to honesthook.com, carries your key in an Authorization header, and comes back as JSON. Whatever Instagram requires on its side — the public page, the path that changes without notice — happens behind that one call and is not your problem.
The handle in the example is the one that produced the response below. If you change it, you get a different account's numbers; the shape stays identical.
Before you copy the block
Put your key in an environment variable rather than in the file. Every example on this page reads HH_KEY, and the free tier needs no card, so there is nothing to protect except the key itself.
Read the response section carefully before you build on a field. Instagram publishes some things on a logged-out profile page and not others — a field we cannot read comes back null, never 0.