API Reference

Meta Ads / API Reference

meta_ads_instagram_hashtag_posts

Meta Ads tool. Search for recent public posts using a specific Instagram hashtag (Business Discovery API). Args: hashtag: Hashtag to search without the # symbol, e.g. 'digitalmarketing' (required). instagram_account_id: Your Instagram Business Account ID (required for auth) (required). page_access_token: Page access token. Falls back to user token if blank. limit: Number of posts to return. Default 10, max 50.

This is a read-only tool: it returns instagram hashtag posts for your Meta Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Instagram hashtag posts in my Meta Ads account for [hashtag], [instagram account id].

It takes 2 required and 2 optional parameters.

Parameters

ParameterTypeRequiredDescription
hashtagstringYesHashtag
instagram_account_idstringYesInstagram Account Id
page_access_tokenstringNoPage Access Token
limitintegerNoLimit

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads