Get user tagged posts

Returns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.

What it does

Returns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.

Tool details

Field	Value
Tool name	instagram_get_user_tagged
Platform	Instagram
REST endpoint	GET /v1/instagram/users/{username}/tagged
Result type	Collection tool

Parameters

Parameter	Type	Required	Description
username	string	Yes	Instagram username (with or without @ symbol)
count	integer	No	Number of posts to fetch (maximum: 12) Default: 12.
cursor	string	No	Pagination cursor
projection_preset	string	No	Defaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fields	string[]	No	Adds top-level keys from data on top of the selected projection_preset.
item_fields	string[]	No	Adds keys from data.orderedItems[] on top of the selected projection_preset.

Example

{
  "name": "instagram_get_user_tagged",
  "arguments": {
    "username": "khaby.lame",
    "count": 12,
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "nextCursor",
      "cursor",
      "itemCount"
    ],
    "item_fields": [
      "totalItems",
      "entityId",
      "name",
      "published",
      "content"
    ]
  }
}

Available data fields

• @context
• type
• partOf
• totalItems
• cursor
• nextCursor
• next
• itemCount
• orderedItems

Available item fields

• type
• id
• url
• entityId
• content
• published
• likeCount
• commentCount
• attributedTo
• location
• tag
• language
• isEdited
• isSponsored
• viewCount
• duration
• contentFormat
• attachment
• image
• audio
• name
• totalItems
• items

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.