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.5

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.5.
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.
This recipe is approval-gated and only processes 08:00-18:00 GMT+8, so do not build an unattended schedule on it.

What I want: show me every product launched in Indonesian sunscreen on Shopee since last week, grouped by shop, with price and any units already recorded. Flag anything that took real volume straight away.

02/ 07

What it tracks

01

Listings new since the last run, grouped by shop

02

Price on each new listing, and any units already recorded against it

03

New listings that took meaningful volume immediately — usually a launch with paid support behind it

04

The previous week's itemid list, kept so next week's diff is possible

03/ 07

How it works

1
Build Shopee search URLs for the category with sortBy=ctime instead of sortBy=sales.
2
Submit to search-items and poll. Approval-gated — hand back the job_id rather than polling for hours.
3
Diff this week's itemid list against the list you kept from last week.
4
Report what is new, grouped by shop, and flag anything already carrying volume.

04/ 07

What a real response looks like

Real search-items frame · keyword "ac window" · sortBy=ctime returns this same shape · 2 items shown

            GET /v1/shopee/search-items/retrieve/{job_id}
            captured 2026-06
          
{
  "page_type": "search",
  "page_params": {
    "keyword": "ac window",
    "filters": {}
  },
  "items": {
    "total_fetched": 300,
    "items": [
      {
        "item_basic": {
          "itemid": 52053072191,
          "shopid": 592127666,
          "name": "AC DAIKIN STV15CXV / FTV15CXV14 ,STANDAR 0,5 PK MALAYSIA",
          "price": 384900000000,
          "sold": 0,
          "ctime": 1765708840,
          "shop_name": "A1 ELECTRONIC"
        }
      },
      {
        "item_basic": {
          "itemid": 26970879014,
          "shopid": 85961994,
          "name": "Midea AC Inverter 1 PK MSIAF-09CRDN2X / 1PK MSIAF-09CRDN2",
          "price": 379900000000,
          "sold": 0,
          "ctime": 1734409964,
          "shop_name": " Sajun Official Store"
        }
      }
    ]
  }
}

05/ 07

Tips from our own runs

Save each week's itemid list. Next week, that list is what turns "recent listings" into "new since last time".

Kick it off yourself each week during 08:00–18:00 GMT+8, when approvals are processed. It can't run on an automatic weekly schedule.

A brand-new listing that's already selling usually has ads behind it. That's a useful signal, so note it next to the launch.

06/ 07

When not to use this

Use this when

New-launch watch

You want a weekly list of new Shopee listings in your category, with the ones already selling flagged.

Use instead →

Category share tracker

This finds launches, not winners. Whether a launch actually took share is a question for the Category share tracker once the month closes.

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

Spot competitor launches the week they go live.