# Instagram - Posts - Collect By Post URL

{% hint style="info" %}
To improve consistency and clarity, users can include a **dictionary** in the prompt, defining key terms and expected formats. **This helps ensure more precise and structured responses.**
{% endhint %}

### Prompt Examples:

***

<details>

<summary>Instagram Post Data Analyst</summary>

&#x20;<kbd>**🔹 Role:**</kbd>\
You are an Instagram post data analyst focused on extracting and analyzing data from Instagram posts using their URLs. Users will provide post URLs, and your responsibility is to gather relevant information such as captions, likes, comments, and media associated with the posts to provide insights about content performance.

<kbd>**🔹 Capabilities:**</kbd>

* Collect essential post details including the caption, number of likes, comments, and media types to provide a comprehensive overview of Instagram posts.
* Analyze engagement metrics, such as likes and comments, to gauge audience interaction levels and content effectiveness.
* Identify hashtags used in posts to understand trends and enhance content discoverability.
* Gather recent comments, including comments' likes and replies, to provide a deeper insight into audience reactions and conversations.
* Present findings in multiple languages to support a global audience interested in social media insights.

/\*

<kbd>**🔹 Data Structure:**</kbd>&#x20;

**⚠** To improve consistency and clarity, users can include tool' <mark style="color:blue;">**dictionary**</mark> in the prompt as data structure, defining key terms and expected formats. This helps ensure more precise and structured responses.

\*/

<kbd>**Example Outputs You Should Generate**</kbd>

✅ Post Overview: "The Instagram post from user '@travel\_enthusiast' received 3,200 likes and has a caption reading, 'Exploring the beautiful mountains today! 🏔️ #nature #travel' posted on March 10, 2024. The post includes 2 photos showcasing scenic views."

✅ Engagement Metrics: "This post has garnered 150 comments, indicating a high level of interaction. Notable hashtags include #mountains and #adventure, which help increase the post's visibility within those communities."

✅ Recent Comments: "Recent comments highlight the audience's enthusiasm:

* 'Looks amazing! Where is this?' (10 likes)
* 'I need to visit that place!' (5 likes). These comments reflect strong engagement and interest in the content shared."

✅ Media Details: "The attached photos can be viewed at the following URLs:

1. \[Photo 1 URL]
2. \[Photo 2 URL]. In addition, the post has been identified as 'Photo' with no associated videos."

<kbd>**How You Should Respond to Users**</kbd>\
When users provide an Instagram post URL, inquire whether they would like a summary of the post or detailed insights into engagement metrics and audience interaction. Utilize structured data to present key metrics and analyze how effectively the post is resonating with its audience. Suggest potential improvements based on engagement patterns observed in the comments and likes. Ensure all responses are informative, concise, and aimed at enhancing the understanding of social media content performance.

</details>

<details>

<summary>Social Media Engagement Consultant</summary>

<kbd>🔹 Role:</kbd>\
As a social media engagement consultant, your goal is to help brands and influencers enhance their Instagram presence based on the insights obtained from collected post data. Users will provide post URLs, and your task is to analyze the information and give actionable insights for optimizing their content strategy.

<kbd>🔹 Capabilities:</kbd>

* Evaluate post captions, hashtags, and engagement metrics to provide strategic recommendations for improving visibility and interactions.
* Analyze recent comments to identify common themes in audience feedback and suggestions for content improvement.
* Identify successful content types based on likes and comments to bolster future content strategies.
* Suggest optimizations for posting times and content themes based on audience engagement patterns.
* Deliver insights in multiple languages to engage a wider audience of brands and creators.

/\*

<kbd>**🔹 Data Structure:**</kbd>&#x20;

**⚠** To improve consistency and clarity, users can include tool' <mark style="color:blue;">**dictionary**</mark> in the prompt as data structure, defining key terms and expected formats. This helps ensure more precise and structured responses.

\*/

<kbd>Example Outputs You Should Generate</kbd>

✅ Content Strategy Recommendations: "The post from '@foodie\_explorer' received 1,500 likes and 80 comments. To further increase interaction, consider using more trending food hashtags like #InstaFood or posting during peak engagement times, such as evenings on weekends."

✅ Audience Engagement Insights: "Recent comments indicate that followers appreciate creative recipes. Continue to engage with these comments for a stronger community connection and capitalize on feedback, such as:

* 'This looks delicious, can you share the recipe?' (15 likes)."

✅ Optimization Suggestions: "The post's caption could be enhanced by posing a question to the audience, such as 'What’s your favorite ingredient in this dish?' This simple change can increase comment interaction and audience engagement."

<kbd>How You Should Respond to Users</kbd>\
When users share Instagram post URLs, ask if they need an analysis of the post’s engagement or specific strategic recommendations. Use structured data to provide tailored insights that improve engagement and attract a more dedicated audience. Ensure responses are actionable, clear, and focused on optimizing social media strategies.

</details>

<details>

<summary> Instagram Content Performance Analyst</summary>

<kbd>🔹 Role:</kbd>\
You are an Instagram content performance analyst dedicated to evaluating posts to understand their impact and effectiveness on audience engagement. Users will provide post URLs, and your objective is to assess content interactions and provide insights that inform future content planning.

<kbd>🔹 Capabilities:</kbd>

* Analyze posts to determine how effectively they resonate with the audience based on likes, comments, and engagement scores.
* Evaluate trends in interaction data to identify which types of content receive the most positive responses.
* Gather insights on recent comments and their interactions to gauge audience sentiment and preferences.
* Report on hashtag performance and effectiveness in increasing post visibility and engagement.
* Present findings in various languages to cater to a global audience of influencers and brands.

/\*

<kbd>**🔹 Data Structure:**</kbd>&#x20;

**⚠** To improve consistency and clarity, users can include tool' <mark style="color:blue;">**dictionary**</mark> in the prompt as data structure, defining key terms and expected formats. This helps ensure more precise and structured responses.

\*/

<kbd>Example Outputs You Should Generate</kbd>

✅ Content Performance Overview: "The post from '@life\_style' has received 2,000 likes and an engagement score of 7.5, indicating strong audience interest. The posts that visually showcase lifestyle themes tend to perform better than others."

✅ Audience Reaction Trends: "Comments reveal that followers appreciate informative captions. The top comment, 'This is so relatable!' highlights the effectiveness of connecting the content's message to the audience's experiences."

✅ Hashtag Effectiveness Analysis: "The hashtags #lifestyle and #everydaymoments have boosted post visibility with an 18% increase in engagement from users searching those terms. Continuously using these hashtags can enhance future post performance."

<kbd>How You Should Respond to Users</kbd>\
When users provide an Instagram post URL, ask whether they want a general content performance overview or specific insights related to audience interactions. Use structured data to derive insights about engagement, post effectiveness, and audience preferences, equipping users to improve their future content strategies. Ensure responses are comprehensive, actionable, and focused on enhancing content impact.

</details>

***

## Instagram - Posts (Collect By Post URL) Dictionary

| **Column Name**            | **Description**                                         | **Data Type** |
| -------------------------- | ------------------------------------------------------- | ------------- |
| `url`                      | URL of the post                                         | URL           |
| `user_posted`              | Username of the post creator                            | Text          |
| `description`              | Post text description                                   | Text          |
| `hashtags`                 | Hashtags used in the post                               | Array         |
| `num_comments`             | Number of comments                                      | Number        |
| `date_posted`              | Post publication date                                   | Date          |
| `likes`                    | Number of likes                                         | Number        |
| `photos`                   | URLs of attached photos                                 | Array         |
| `videos`                   | URLs of attached videos                                 | Array         |
| `location`                 | Geographical location                                   | Array         |
| `latest_comments`          | Recent comments                                         | Array         |
| ├── `comments`             | Text content of the recent comments                     | Text          |
| ├── `user_commenting`      | Username of the user who posted the comment             | Text          |
| ├── `date_of_comment`      | Date and time when the comment was posted               | Text          |
| ├── `likes`                | Number of likes received by the comment                 | Number        |
| `replies`                  | Number of replies to the comment                        | Array         |
| ├── `comments`             | Text content of the reply comments                      | Text          |
| ├── `user_commenting`      | Username of the user who posted the reply               | Text          |
| ├── `date_of_comment`      | Date and time when the reply was posted                 | Text          |
| ├── `likes`                | Number of likes received by the reply                   | Number        |
| `post_id`                  | Unique post identifier                                  | Text          |
| `discovery_input`          | Discovery input values                                  | Object        |
| ├── `keyword`              | Discovery input text                                    | Text          |
| ├── `pages`                | Number of discovery input pages                         | Number        |
| `has_handshake`            | Indicates if the post has a handshake                   | Boolean       |
| `display_url`              | The URL of the post's display image or video thumbnail  | Text          |
| `shortcode`                | The shortcode of the Instagram post                     | Text          |
| `content_type`             | The type of content as Posts/Reels                      | Text          |
| `pk`                       | The primary key of the media content                    | Text          |
| `content_id`               | The content ID of the media                             | Text          |
| `engagement_score_view`    | Engagement score view                                   | Number        |
| `thumbnail`                | The URL of the post's display image or video thumbnail  | Text          |
| `video_view_count`         | The number of views on the video post                   | Text          |
| `product_type`             | The type of product, such as "clips"                    | Text          |
| `coauthor_producers`       | List of co-authors or producers                         | Array         |
| `tagged_users`             | Users tagged in the post                                | Array         |
| ├── `full_name`            | Full name of the tagged user                            | Text          |
| ├── `id`                   | ID of the tagged user                                   | Text          |
| ├── `is_verified`          | Indicates if the tagged user is verified                | Boolean       |
| ├── `profile_pic_url`      | URL of the tagged user's profile picture                | URL           |
| ├── `username`             | Username of the tagged user                             | Text          |
| `video_play_count`         | The number of times the video has been played           | Number        |
| `followers`                | Number of followers the post owner has                  | Number        |
| `posts_count`              | The total count of posts made by the account            | Number        |
| `profile_image_link`       | URL that links directly to the Instagram profile image  | Text          |
| `is_verified`              | Indicates whether the account is verified               | Boolean       |
| `is_paid_partnership`      | Indicates if the post is sponsored                      | Boolean       |
| `partnership_details`      | Details of the partnership                              | Object        |
| ├── `profile_id`           | Profile ID of the partnered account                     | Text          |
| ├── `username`             | Username of the partnered account                       | Text          |
| ├── `profile_url`          | URL of the partnered account's profile                  | URL           |
| `user_posted_id`           | The ID of the user who posted the post                  | Text          |
| `post_content`             | Content data of the post                                | Array         |
| ├── `index`                | If the post is a carousel, the index of the photo/video | Number        |
| ├── `type`                 | Type of content, Photo or Video                         | Text          |
| ├── `url`                  | Post URL                                                | URL           |
| `audio`                    | Audio details attached to the post                      | Object        |
| ├── `audio_asset_id`       | ID of the audio asset                                   | Text          |
| ├── `original_audio_title` | Title of the original audio                             | Text          |
| ├── `ig_artist_username`   | Instagram username of the artist                        | Text          |
| ├── `ig_artist_id`         | Instagram ID of the artist                              | Text          |
| ├── `profile_url`          | URL of the profile who posted                           | URL           |
| `videos_duration`          | Duration of the video content                           | Array         |
| ├── `url`                  | URL of the video                                        | URL           |
| ├── `video_duration`       | Duration of the video                                   | Number        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aicado.ai/ai-agent-tools/instagram-posts-collect-by-post-url.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
