01/ 07

The prompt

Give it to Claude, ChatGPT or Cursor along with your key. It reads the docs, follows the recipe, and asks you before spending anything.

Recipe 2.8

Read https://data.magpieiq.com/llms.txt and the docs at https://data.magpieiq.com/docs.
Then fetch https://data.magpieiq.com/skill/SKILL.md and follow recipe 2.8.
My Magpie API key is: <paste your key>

Rules: submit only the URLs or items I give you; poll with backoff rather than tight-looping; write the raw payload to disk before analysing it, because re-running a job costs credits again; report anything that failed rather than quietly returning a shorter table; ask me before spending any credits.

What I want: every Monday, check where our listings rank on Tokopedia for "gitar yamaha", "gitar klasik" and "gitar akustik" (our shop is <your shop name>). Show me our best position for each keyword, who sits above us, and how that changed since last week.

02/ 07

What it tracks

01

Your listing's position for each keyword, counted from 1 in result order

02

Who ranks above you, with their price, rating and sold label

03

How many results each keyword returns, so a top-10 spot can be read in context

04

Rank movement between runs, keyword by keyword

03/ 07

How it works

1
Submit POST /v1/tokopedia/search/bulk/submit with {"items":[{"list_type":"search","keyword":"gitar yamaha","product_limit":60}]}, up to 50 keywords at a time.
2
Poll GET /v1/tokopedia/search/bulk/retrieve/{job_id} and download each finished item's results file from its download_url.
3
Read the products array in order: a listing's rank is its position, counting from 1. Match yours by id or shop.id.
4
Save each run and compare ranks keyword by keyword against the previous one.

04/ 07

What a real response looks like

Real Tokopedia search results · keyword "gitar yamaha" · first 3 of 60 products, selected fields

            GET /v1/tokopedia/search/bulk/retrieve/{job_id} → download_url
            captured 2026-09-16
          
{
  "keyword": "gitar yamaha",
  "list_type": "search",
  "scraped_at": "2026-09-16T12:52:29.112319+00:00",
  "params": {
    "q": "gitar yamaha",
    "ob": 5,
    "totalData": 320
  },
  "products": [
    {
      "id": "15171301308",
      "name": "Yamaha Gitar Klasik C-315 / C 315 / C315 - Natural + Softcase & 2 Pick",
      "shop": {
        "id": "596297",
        "name": "W Musik",
        "city": "Jakarta Utara"
      },
      "price": {
        "number": 1199000
      },
      "rating": "4.9",
      "labelGroups": [
        {
          "title": "1rb+ terjual"
        }
      ],
      "category": {
        "breadcrumb": "film-musik/gitar-bass/gitar-klasik"
      },
      "ads": {
        "id": "",
        "tag": 0
      }
    },
    {
      "id": "8871996588",
      "name": "Gitar Klasik Yamaha C-315 / YAMAHA GUITAR CLASSIC C315 / C 315 ORIGINAL",
      "shop": {
        "id": "600373",
        "name": "DOREMI MUSIC",
        "city": "Tangerang"
      },
      "price": {
        "number": 1228000
      },
      "rating": "4.9",
      "labelGroups": [
        {
          "title": "750+ terjual"
        }
      ],
      "category": {
        "breadcrumb": "film-musik/gitar-bass/gitar-klasik"
      },
      "ads": {
        "id": "",
        "tag": 0
      }
    },
    {
      "id": "411737882",
      "name": "Yamaha Gitar Akustik Folk F-310 F310 F 310 - NT+ Softcase & 2pick",
      "shop": {
        "id": "3464482",
        "name": "Wijayamusikputra",
        "city": "Jakarta Utara"
      },
      "price": {
        "number": 1565000
      },
      "rating": "5.0",
      "labelGroups": [
        {
          "title": "500+ terjual"
        }
      ],
      "category": {
        "breadcrumb": "film-musik/gitar-bass/gitar-akustik"
      },
      "ads": {
        "id": "",
        "tag": 0
      }
    }
  ]
}

05/ 07

Tips from our own runs

Not sure which keywords to track? Lazada's keyword-tracking endpoint lists search terms that led to orders in the last 30 days. It's big (one call gave us about 200,000), so save it and filter to your product words.

Rank here follows the scraper's fixed result order, which makes it great for spotting movement week to week. Just don't present it as exactly what every shopper sees.

Keyword search runs without approval, and it came back for us in the evening too, so it's safe to put on a weekly schedule.

A sold label like "1rb+ terjual" is a lifetime bucket rather than this month's sales, so use it for context rather than trend.

Download each results file soon after the job finishes. The link we got stayed valid for seven days.

06/ 07

When not to use this

Use this when

Keyword rank tracker

You sell on Tokopedia and want to know where your listings show up for the searches your buyers actually use.

Use instead →

Category share tracker

Rank tells you who is visible, not who is actually selling. To see which brands win the category on sales, use the Category share tracker.

07/ 07

Other tools

Get a key, then paste the prompt.

New accounts start with free trial credits. You generate your own key from the dashboard.

Get an API key Read the recipe in the docs

See where you rank for every keyword that matters.