How to Use Instagram keyword search in Gemini CLI
Find Instagram accounts, posts, and Reels in one keyword search, with pagination for more results. Use it to research a brand or topic across content types before narrowing your review.
Prompts to try with Instagram keyword search in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Instagram keyword search for Patagonia and save the returned results in this project, separated into accounts, posts, and Reels where the response identifies the type.
Use Instagram keyword search for LEGO Botanicals and create a Markdown research brief in this project with relevant returned posts and Reels.
Use Instagram keyword search for Nike Running and Adidas Running, then add a comparison of returned content themes to this project's research folder.
Use Instagram keyword search for Nintendo Switch 2 and build a review table from the actual response, preserving the returned data for each result.
Use Instagram keyword search for IKEA, retrieve up to three pages when available, and add a result review view to this project.
How to set up Instagram keyword search in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Instagram keyword search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "tikhub", "model": "tikhub/instagram-v2-general-search", "input": { "keyword": "cat" } }'
Then paste one of the prompts above: Gemini CLI finds Instagram keyword search on Spiral, shows the price and runs it.
Instagram keyword search providers and prices
Spiral runs Instagram keyword search through TikHub. Open a card for today's price, with every fee included.
What can you do with Instagram keyword search in Gemini CLI?
Build a reviewable Instagram brand research dataset from mixed account, post, and Reel search results. A coding agent can organize the responses in your project and add pagination to extend the search.
Brand search review
Search for Patagonia and review the returned accounts, posts, and Reels to see which results concern the brand.
Content planning
Search for LEGO Botanicals and turn relevant posts and Reels into a list of content ideas, with a returned example supporting each idea.
Competitor research
Run separate searches for Nike Running and Adidas Running, then compare the themes in the returned content.
Public creator discovery
Search for National Geographic and shortlist public creator or publisher accounts that appear relevant to a nature content brief.
Product launch research
Search for Nintendo Switch 2 and organize relevant posts and Reels by the product topics they discuss.
Recurring search brief
Repeat a search for IKEA weekly and summarize newly observed relevant results, allowing for the visitor-view data delay.
More on Instagram keyword search and Gemini CLI
Overview
Instagram keyword search in other agents
Questions about Instagram keyword search in Gemini CLI
Can Gemini CLI use Instagram keyword search?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Instagram keyword search like any built-in tool.
How much does Instagram keyword search cost in Gemini CLI?
$0.0026 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a TikHub account to use Instagram keyword search in Gemini CLI?
No. Spiral runs Instagram keyword search on its own TikHub account. You sign in to Spiral once and never paste a key.
How long does it take to set up Instagram keyword search in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Instagram keyword search runs?
Instagram keyword search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.
What kinds of Instagram results can a keyword search return?
Results can include accounts, posts, and Reels in the same response. This makes the search useful for exploring a brand or topic across several content types.
How fresh is the Instagram data?
TikHub says its Instagram visitor-view figures can lag reality by a few days, especially counts and statistics. A daily search comparison should therefore allow for delayed changes.
Can I retrieve more than the first page of search results?
Yes. The search supports pagination using a token returned by the previous response.
Does this search cover private Instagram content?
TikHub describes its Instagram data as public data from public accounts. Private content falls outside that stated coverage.
Can I reuse the Instagram content I find?
Retrieval does not settle copyright permission. TikHub's terms make you responsible for ensuring your use of retrieved content does not infringe third-party copyrights.
Start using Instagram keyword search in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


