Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · Social Media

How to Use Instagram post media ID in Windsurf

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.

Prompts to try with Instagram post media ID in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use Instagram post media ID to convert NASA Webb's post shortcode DeJ28eTxo4s and add the returned mapping to our project's content catalog.

Instagram post media IDWindsurf
Try asking
  • Use Instagram post media ID for DeJ28eTxo4s, then find matching media IDs in our reporting fixtures and show the matching records.

  • Use Instagram post media ID to resolve https://www.instagram.com/p/DeJ28eTxo4s/ and add its returned ID to the corresponding row in our public-posts CSV.

  • Use Instagram post media ID for NASA Webb's DeJ28eTxo4s post and compare the result with the mapping in our import code.

  • Use Instagram post media ID to convert DeJ28eTxo4s, then update our import preview to display the returned conversion status, shortcode, and media ID.

How to set up Instagram post media ID in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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.

    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.

    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: Windsurf finds Instagram post media ID on Spiral, shows the price and runs it.

Instagram post media ID providers and prices

Spiral runs Instagram post media ID through TikHub. Open a card for today's price, with every fee included.

TikHubSocial Media
Instagram V1 · Convert shortcode to media ID
tikhub/instagram-v1-shortcode-to-media-id

What can you do with Instagram post media ID in Windsurf?

Add Instagram media IDs to the public post links already stored in your project. A coding agent can use the returned mappings to reconcile imports, merge duplicate references, and backfill a content 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.

Questions about Instagram post media ID in Windsurf

Can Windsurf use Instagram post media ID?

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

How much does Instagram post media ID cost in Windsurf?

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

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

No. Spiral runs Instagram post media ID 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 post media ID in Windsurf?

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

Does Windsurf wait while Instagram post media ID runs?

Instagram post media ID runs in the background. Windsurf 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.

Get started

Start using Instagram post media ID in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options