> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Instagram guides

> Find event posts by hashtag, venue and date, then select comments and potential creators.

Pick the Instagram guide by the result you need. For a post or Reel you already have, save an [engagement snapshot](/guides/instagram-post-snapshot) or export a [comment table](/guides/instagram-comment-export). For creator partnerships, [start with a seed account](/guides/instagram-creator-shortlist). To find event posts, request `instagram.fetch_hashtag_posts` for the event hashtag and `instagram.fetch_location_posts` for the venue, as the section below shows.

## Choose a task

* [Post metric snapshot](/guides/instagram-post-snapshot)
* [Creator review sheet](/guides/instagram-creator-shortlist)
* [Reel comment export](/guides/instagram-comment-export)

## After a store event, how do I find posts worth reviewing by tag and location?

Request one batch for the known event hashtag and one batch for the verified venue. Remove the leading `#` from the hashtag. Set `tab: "recent"` for the location feed, then filter the posts by the event dates. The location request needs the venue's actual `location_id`. If two venues share a name, confirm the city and store before choosing the `location_id`.

```json
{"action":"instagram.fetch_hashtag_posts","params":{"hashtag":"<event hashtag>"}}
```

```json
{"action":"instagram.fetch_location_posts","params":{"location_id":"<verified location ID>","tab":"recent"}}
```

POST both request bodies to `https://api.beatapi.io/v1/social-data/call` with BeatAPI Bearer authentication. For each post, record the post link, the discovery source (hashtag or location), the activity date or attendance evidence, and the reason the post belongs in the review. When a post appears in both batches, keep one row with both sources. For a Reel worth following up, [read the selected comments](/guides/instagram-comment-export). For a creator worth considering, use the [shortlist guide](/guides/instagram-creator-shortlist) to review the creator's recent work and similar accounts.

For the next page, pass the cursor from the same hashtag or location response as `end_cursor`, and keep `tab: "recent"` for the location feed. Record the dates covered and the number of selected posts. Mark posts that carry the venue tag but show no attendance evidence for follow-up.

If you only have the venue on a map, pass the venue's coordinates as numbers in `latitude` and `longitude` to `instagram.v2.search_by_coordinates`. Check each candidate venue's name and address before using the candidate's ID to fetch posts. If no venue can be confirmed, deliver the hashtag batch and record the hashtag batch's scope.

## Related content

[Instagram questions](/faq/instagram)