Instagram posts

Recent posts from one Instagram profile with captions, engagement counts, media URLs, and timestamps.

Use when you need a creator’s or brand’s recent Instagram content, to measure engagement over time, or to pull captions and hashtags for analysis.

Price

$0.0045 per post. That is the rate you pay for each post the call returns, so the total depends on how many it produces. Billing follows actual usage, so a call that returns fewer posts costs less. discover and inspect also return a ceiling for your specific request, which is a maximum you will never be charged above.

Input

Field	Type	Required	Notes
`username`	`array`	yes	Instagram username, profile URL, or post URL. One target per call: resultsLimit applies per target, so batching several here would bill past the hold sized for this request.
`resultsLimit`	`integer`		Maximum posts per profile Defaults to `20`.
`dataDetailLevel`	`basicData`, `detailedData`		detailedData is billed extra at $0.0008 per post Defaults to `"basicData"`.
`skipPinnedPosts`	`boolean`		Defaults to `false`.
`onlyPostsNewerThan`	`string`		YYYY-MM-DD, ISO datetime, or relative like “3 months”

Goro forwards your input to the underlying tool unchanged, so any field the tool accepts works here even if it is not listed above.

Example

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"instagram.posts","input":{"username":["example"],"resultsLimit":3}}'

Response

One row of the response. Values are illustrative.

{
  "id": "3401234567890123456",
  "url": "https://instagram.com/example-account/DLNsnpUTdVS/",
  "type": "Image",
  "likes": 184203,
  "caption": "Photograph by @thomaspeschak",
  "comments": 1204,
  "shortcode": "DLNsnpUTdVS",
  "timestamp": "2026-07-01T12:00:00.000Z",
  "display_url": "https://example.com/media/sample.jpg",
  "owner_username": "natgeo"
}

Guide

CLI reference

API reference

Tools

Instagram posts

Price

Input

Example

Response

​Price

​Input

​Example

​Response

Price

Input

Example

Response