[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Instagram V1 Convert media ID to shortcode](https://spiral.ai/integrations/gemini-cli/instagram-v1-convert-media-id-to-shortcode)

# How to Use Instagram V1 Convert media ID to shortcode in Gemini CLI

Returns conversion status, the original media ID, and the Instagram post shortcode. Use it to turn stored post IDs into Instagram links for reports or review queues.

|  |  |
| --- | --- |
| Model | Instagram V1 Convert media ID to shortcode |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Instagram V1 Convert media ID to shortcode in Gemini CLI

- Use Instagram post shortcode for NASA media ID 3996242083173720380, then add the resulting post link to our report fixture.
- Use Instagram post shortcode to backfill links for the @nasa post IDs in data/nasa-posts.csv, preserving every ID as text.
- Use Instagram post shortcode for NASA media ID 3996242083173720380 and update our archive renderer to show its returned shortcode as a clickable Instagram link.
- Use Instagram post shortcode for NASA media ID 3996242083173720380, then compare the result with Dd1gQBsCWE8 in our migration fixture.
- Use Instagram post shortcode for NASA media ID 3996242083173720380 and trace whether our CSV importer preserves those exact digits before conversion.

## How to set up Instagram V1 Convert media ID to shortcode in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Instagram V1 Convert media ID to shortcode**: One request; the result comes back by polling or a webhook.

```bash
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-v1-media-id-to-shortcode",
    "input": {
      "media_id": "3774507992167247878"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Instagram V1 Convert media ID to shortcode on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Instagram V1 Convert media ID to shortcode tools and prices

- [Instagram V1 · Convert media ID to shortcode](https://spiral.ai/tools/tikhub/tikhub/instagram-v1-media-id-to-shortcode) (TikHub): $0.0013 per request.

## What can you do with Instagram V1 Convert media ID to shortcode in Gemini CLI?

Add clickable Instagram source links to a project's stored post records. A coding agent can connect the conversion result to an importer, report generator, or archive migration while preserving long IDs as strings.

### Add source links to campaign reports

Convert stored brand post IDs into shortcodes, then add Instagram links beside the corresponding campaign results.

### Repair an internal content archive

Fill missing post links in an archive that retained Instagram media IDs but lost the original URLs.

### Prepare an editorial review queue

Give editors clickable references for public business posts submitted as numeric media IDs.

### Reconcile post references

Convert media IDs to shortcodes before matching an internal campaign export against a spreadsheet of Instagram post links.

### Attach citations to research notes

Turn saved public organization post IDs into source links for an internal content research brief.

### Check an identifier migration

Compare converted shortcodes with previously saved shortcodes to find discrepancies after moving a post archive between databases.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Instagram V1 Convert media ID to shortcode in other agents

- [Amp](https://spiral.ai/integrations/amp/instagram-v1-convert-media-id-to-shortcode)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/instagram-v1-convert-media-id-to-shortcode)
- [Claude](https://spiral.ai/integrations/claude-desktop/instagram-v1-convert-media-id-to-shortcode)
- [Claude Code](https://spiral.ai/integrations/claude-code/instagram-v1-convert-media-id-to-shortcode)
- [Cline](https://spiral.ai/integrations/cline/instagram-v1-convert-media-id-to-shortcode)
- [Codex](https://spiral.ai/integrations/codex/instagram-v1-convert-media-id-to-shortcode)
- [Cursor](https://spiral.ai/integrations/cursor/instagram-v1-convert-media-id-to-shortcode)
- [Devin](https://spiral.ai/integrations/devin/instagram-v1-convert-media-id-to-shortcode)
- [dots](https://spiral.ai/integrations/dots/instagram-v1-convert-media-id-to-shortcode)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/instagram-v1-convert-media-id-to-shortcode)
- [Gemini](https://spiral.ai/integrations/gemini/instagram-v1-convert-media-id-to-shortcode)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/instagram-v1-convert-media-id-to-shortcode)
- [goose](https://spiral.ai/integrations/goose/instagram-v1-convert-media-id-to-shortcode)
- [Grok](https://spiral.ai/integrations/grok/instagram-v1-convert-media-id-to-shortcode)
- [Grok Build](https://spiral.ai/integrations/grok-build/instagram-v1-convert-media-id-to-shortcode)
- [Hermes](https://spiral.ai/integrations/hermes/instagram-v1-convert-media-id-to-shortcode)
- [Instinct](https://spiral.ai/integrations/instinct/instagram-v1-convert-media-id-to-shortcode)
- [Manus](https://spiral.ai/integrations/manus/instagram-v1-convert-media-id-to-shortcode)
- [Muse](https://spiral.ai/integrations/muse/instagram-v1-convert-media-id-to-shortcode)
- [Muse Code](https://spiral.ai/integrations/muse-code/instagram-v1-convert-media-id-to-shortcode)
- [n8n](https://spiral.ai/integrations/n8n/instagram-v1-convert-media-id-to-shortcode)
- [Notion](https://spiral.ai/integrations/notion/instagram-v1-convert-media-id-to-shortcode)
- [OpenClaw](https://spiral.ai/integrations/openclaw/instagram-v1-convert-media-id-to-shortcode)
- [opencode](https://spiral.ai/integrations/opencode/instagram-v1-convert-media-id-to-shortcode)
- [Perplexity](https://spiral.ai/integrations/perplexity/instagram-v1-convert-media-id-to-shortcode)
- [Raycast](https://spiral.ai/integrations/raycast/instagram-v1-convert-media-id-to-shortcode)
- [VS Code](https://spiral.ai/integrations/vscode/instagram-v1-convert-media-id-to-shortcode)
- [Windsurf](https://spiral.ai/integrations/windsurf/instagram-v1-convert-media-id-to-shortcode)
- [Zapier](https://spiral.ai/integrations/zapier/instagram-v1-convert-media-id-to-shortcode)

## More Gemini CLI guides

- [Instagram User Tagged Posts](https://spiral.ai/integrations/gemini-cli/instagram-user-tagged-posts)
- [Instagram V1 Get comment replies](https://spiral.ai/integrations/gemini-cli/instagram-v1-get-comment-replies)
- [Instagram Search Reels](https://spiral.ai/integrations/gemini-cli/instagram-search-reels)
- [Instagram V1 Get post by URL V2](https://spiral.ai/integrations/gemini-cli/instagram-v1-get-post-by-url-v2)
- [Instagram Search Instagram Profiles](https://spiral.ai/integrations/gemini-cli/instagram-search-instagram-profiles)
- [Instagram V1 Get posts by hashtag](https://spiral.ai/integrations/gemini-cli/instagram-v1-get-posts-by-hashtag)

## Questions about Instagram V1 Convert media ID to shortcode in Gemini CLI

**Can Gemini CLI use Instagram V1 Convert media ID to shortcode?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Instagram V1 Convert media ID to shortcode like any built-in tool.

**How much does Instagram V1 Convert media ID to shortcode cost in Gemini CLI?**

$0.0013 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 V1 Convert media ID to shortcode in Gemini CLI?**

No. Spiral runs Instagram V1 Convert media ID to shortcode 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 V1 Convert media ID to shortcode in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Instagram V1 Convert media ID to shortcode runs?**

Instagram V1 Convert media ID to shortcode runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**What does Instagram post shortcode return?**

TikHub documents three output values: conversion status, the original media ID, and the converted shortcode. The documented payload covers identifier conversion.

**How do I turn the shortcode into an Instagram link?**

Insert the returned shortcode into https://www.instagram.com/p/{shortcode}/. TikHub explicitly documents this post URL format.

**Does successful conversion mean the post is still available?**

No. Deleted Instagram posts can still have convertible media IDs, so a shortcode alone does not confirm current availability.

**Why can an Instagram media ID produce the wrong shortcode?**

Check whether the ID passed through a JavaScript Number. Instagram's documented example IDs exceed JavaScript's safe integer ceiling of 9,007,199,254,740,991; preserve the original digits as a string.

**Can an Instagram shortcode reveal private content?**

TikHub's Instagram coverage excludes private accounts, direct messages, and non-public insights. Constructing a post link does not expand that coverage.

