[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [Instagram post media ID](https://spiral.ai/integrations/dots/instagram-post-media-id)

# How to Use Instagram post media ID in dots

Convert an Instagram post shortcode into its media ID, with the original shortcode and conversion status. Use it to match post links to records indexed by media ID.

|  |  |
| --- | --- |
| Model | Instagram post media ID |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Instagram post media ID in dots

- Every weekday, use Instagram post media ID for new NASA Webb post links in my research queue, starting with https://www.instagram.com/p/DeJ28eTxo4s/, and add the returned mappings to my reference table.
- Each morning, use Instagram post media ID on unresolved public @nasawebb post references in my intake queue, using DeJ28eTxo4s as the first reference, and report their conversion statuses.
- Every Friday, use Instagram post media ID for newly submitted public @nasawebb post links, beginning with https://www.instagram.com/p/DeJ28eTxo4s/, and prepare a weekly mapping table.
- Each evening, use Instagram post media ID for new NASA Webb references in my catalog, starting with DeJ28eTxo4s, and flag returned IDs already present in the catalog.
- Every Monday, use Instagram post media ID to resolve pending public @nasawebb post shortcodes, including DeJ28eTxo4s, and produce a list of conversions ready for reporting.

## How to set up Instagram post media ID in dots

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

### Use the Spiral skill

1. **Send dots 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

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

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### 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 post media ID**: 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-shortcode-to-media-id",
    "input": {
      "shortcode": "DRhvwVLAHAG"
    }
  }'
```

Then paste one of the prompts above: dots finds Instagram post media ID on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/dots

## Instagram post media ID tools and prices

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

## What can you do with Instagram post media ID in dots?

Keep incoming public Instagram post references paired with their media IDs. A scheduled agent can process new references and prepare mappings for an internal campaign or research catalog.

### Match campaign links to reporting records

Convert public brand post shortcodes into media IDs, then match them to an existing campaign report indexed by those IDs.

### Remove duplicate post references

Resolve collected public post links to media IDs and consolidate references that map to the same returned ID.

### Backfill a public content catalog

Add returned media IDs beside existing Instagram post links in an internal brand or publisher content catalog.

### Reconcile agency handoffs

Translate public post shortcodes from an agency's delivery list into media IDs for comparison with the client's reporting export.

### Prepare a research reference table

Pair public institutional post links with their returned media IDs so researchers can connect references to existing post records.

### Resolve new links in a recurring intake

Convert newly submitted public business post shortcodes into media IDs before adding them to an internal reporting queue.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All dots guides](https://spiral.ai/integrations/dots)

## Instagram post media ID in other agents

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

## More dots guides

- [Instagram post likes](https://spiral.ai/integrations/dots/instagram-post-likes)
- [Instagram post shortcode](https://spiral.ai/integrations/dots/instagram-post-shortcode)
- [Instagram post likers](https://spiral.ai/integrations/dots/instagram-post-likers)
- [Instagram post shortcode to media ID](https://spiral.ai/integrations/dots/instagram-post-shortcode-to-media-id)
- [Instagram post embed](https://spiral.ai/integrations/dots/instagram-post-embed)
- [Instagram posts using audio](https://spiral.ai/integrations/dots/instagram-posts-using-audio)

## Questions about Instagram post media ID in dots

**Can dots use Instagram post media ID?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run Instagram post media ID like any built-in tool.

**How much does Instagram post media ID cost in dots?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a TikHub account to use Instagram post media ID in dots?**

You need no TikHub account. dots uses one Spiral API key for every tool, and Spiral runs Instagram post media ID on its own TikHub account.

**How long does it take to set up Instagram post media ID in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while Instagram post media ID runs?**

Instagram post media ID runs in the background. dots starts the run, checks on it and gives you the json when it's ready.

**What does the Instagram conversion return?**

TikHub documents three outputs: conversion status, the original shortcode, and the converted media ID. The documented result describes an identifier conversion, rather than post content or engagement statistics.

**What does an Instagram shortcode identify?**

It identifies a post within its URL. TikHub's example uses DRhvwVLAHAG from instagram.com/p/DRhvwVLAHAG/.

**Does converting a shortcode provide access to private posts?**

TikHub says it does not access or store private, restricted, or password-protected platform content. A converted identifier does not grant permission to view that content.

**Does TikHub guarantee a freshly fetched response?**

TikHub's privacy policy says data returned through API requests may be cached. The conversion's documented outputs are status and identifiers, so this result should not be presented as a live engagement snapshot.

**Does access through TikHub include ownership of Instagram content?**

TikHub says it provides data-access tools and does not own the underlying data. Do not treat a returned media ID as a license to republish the associated content.

