Instagram guides
Pick the Instagram guide by the result you need. For a post or Reel you already have, save an engagement snapshot or export a comment table. For creator partnerships, start with a seed account. 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
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.
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. For a creator worth considering, use the shortlist guide 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.

