batch
BATCHES: run any Logimu endpoint over a whole list in one job and come back for the results - the same batch API as REST /v1/batches (see https://api.logimu.com/docs#batch). action=estimate prices a list before anything is billed (free); action=create makes a named, re-runnable batch (add start=true to launch its first run at once); action=run launches a run of an existing batch; action=status reports a batch (runs, line stats) or, with run_id, one run's progress (rows done, credits so far, queue position); action=results returns completed result rows of a run, mid-run too (limit / offset to page; jsonl_url and csv_url give the full download); action=list lists the key's batches; action=schedule repeats a batch daily / weekly / monthly (credit_ceiling, webhook_url); action=delete removes a batch. USE WHEN the user has more than a handful of ASINs, barcodes, search terms, seller ids, brands or seeds to run, wants a daily/weekly refresh, or wants a CSV. Kinds: product (asins or gtins - or source=tracked for the ASINs this key tracks, typically with include [history_only] at 0.05 a row), search (terms, live SERP), seller / brand / category / keywords (paid plans), and every other endpoint as its own kind (shopping, warehouse_search, bestsellers, offers, deals, seller_products, seller_brands, seller_network, brand_sellers, brand_network, keywords_compare, categories, category_search, brands_top, brands_movers, sellers_top, sellers_movers, categories_top) with the endpoint's query parameters in params. Each row bills what the endpoint bills; failed, not-found and duplicate rows are never billed; runs are serialized per marketplace. COST estimate / status / results / list are free; create + run queue billable rows (the estimate is the ceiling). API key required (keyed lanes).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | estimate / create: product (default), search, seller, brand, category, keywords, or any endpoint kind named in the description. | product |
| mode | No | product / seller batches: cache = warehouse only, live = scrape every row, auto = warehouse when fresh enough (required on create for product batches). | |
| name | No | create: the batch's name (1-120 characters). | |
| urls | No | bestsellers batches: Best Sellers URLs. | |
| asins | No | product batches: the ASINs (or Walmart item ids). | |
| gtins | No | product batches: barcodes instead of ASINs. | |
| limit | No | results: rows to return (page with offset; the download URLs carry everything). | |
| pages | No | search batches: pages per term (1-3); ranked-list batches: pages of 25 rows (1-40). | |
| seeds | No | keywords / keywords_compare batches: seed terms. | |
| start | No | create: also launch the first run at once. | |
| terms | No | search / shopping / warehouse_search / category_search batches: the queries. | |
| action | Yes | What to do (see the tool description). | |
| brands | No | brand, brand_sellers, brand_network batches. | |
| offset | No | results: rows to skip. | |
| params | No | endpoint kinds: the endpoint's query parameters, fixed for every row. | |
| run_id | No | For status (one run's progress) and results. | |
| source | No | product batches: tracked = the ASINs this key tracks on the marketplace instead of a list. | |
| country | No | estimate / create: us, uk, de, ca, au, fr, it, es, jp, mx, br, walmart (search batches Amazon only). | us |
| include | No | Extras: history (seller / brand / category / keywords), reviews, used, offer_history, bsr_history, history_only (product), blocks (search). | |
| batch_id | No | For run / status / results / schedule / delete. | |
| schedule | No | schedule: how often the batch re-runs (none stops the schedule). | |
| seller_ids | No | seller, seller_products, seller_brands, seller_network batches. | |
| webhook_url | No | schedule: POSTed on run completion / pause, HMAC-SHA256 signed; the secret is returned once. | |
| category_ids | No | category / categories batches (ids, or root); deals batches (deals department ids, or all for the whole deals page). | |
| max_age_days | No | ||
| credit_ceiling | No | schedule: a firing whose fresh estimate exceeds this does not run (email instead); default 2x the estimate. | |
| history_points | No | ||
| history_sellers | No | ||
| schedule_enabled | No | schedule: pause without deleting. |