Grabblist

Test connectivity to Grabblist and return service version.

Get all saved items from the user's Grabblist. Each item is a static snapshot — data reflects the moment it was saved, not current prices.

Get full details of a saved item by ID. Returns a static snapshot from the user's Grabblist.

Save an item to the user's Grabblist. Creates a static snapshot — Grabblist does not monitor prices or auto-update data. Only include fields with values available from the source. Price is optional: omit it for videos and other things without a price. If no image is provided, the server attempts to fetch og:image automatically.

Remove one or more items from the user's Grabblist (soft-delete). Pass a single id or an array of ids for batch operations.

Restore one or more deleted (archived) items back to the Grabblist. Pass a single id or an array of ids for batch restore.

Search within the user's saved items by keyword

Manually update the price on a saved item. Records old and new price for comparison. This is a manual correction, not automatic price tracking.

Edit fields on one or more saved items. Pass a single id or an array of ids for batch updates (same fields applied to all). For batch: attributes are REPLACED not merged, og:image fallback is skipped.

List all collections OR get a specific collection with its items. Without id: returns all collections with counts/values. With id: returns that collection's metadata and all items inside (with optional filters).

Create a new collection (folder) in the user's Grabblist to organize saved items.

Add a saved item to a collection. Both the item and collection must already exist.

Remove one or more items from a collection. Pass a single item_id or an array of item_ids for batch removal. Items are NOT deleted — they stay in the Grabblist.

Permanently delete a collection. Items inside are not deleted — they stay in the Grabblist.

Update a collection's name, icon, description, budget, or sharing status. Only provide the fields you want to change — omitted fields stay unchanged. Set is_public=true to share (returns public URL), is_public=false to unshare.

Create typed relations between items: alternative (A or B), complement (A and B together), upgrade (B replaces A), duplicate (same item different site), same_seller. Supports single pair (from_id, to_id, relation) or bulk (pairs array).

Get all relations for an item — alternatives, complements, upgrades, duplicates. Returns the item and all connected items with their relation types.

Remove a relation between two items.

Get the change history for a saved item — who changed what and when.

Get recent activity on a collection — additions, removals, edits.

Set the pinned "Top Picks" items for a collection (max 3). Pinned items are highlighted on the share page.

Send feedback, a bug report or a feature request to the Grabblist team. Only call this when the user asks to report something, or agrees after you offer to report a problem (parsing failure, broken URL, missing feature); show them the message first. Be specific about what went wrong and where.