Skip to main content

​
Overview

The bigdata_create_watchlist tool creates a new watchlist in your Bigdata.com account from a display name and a list of Knowledge Graph IDs. The watchlist is owned by the caller and appears immediately in the Bigdata App under Watchlists, where it can be opened, shared, and used like any watchlist created in the product. The returned watchlist id is the handle for every follow-up: fetch it with bigdata_get_watchlist, change it with bigdata_edit_watchlist, or remove it with bigdata_delete_watchlist.

​
When to Use

Create Watchlist is ideal for:
  • Importing a portfolio: Turning a spreadsheet, PDF, or pasted list of holdings into a watchlist your agent can revisit
  • Saving a screen: Persisting the output of bigdata_screen_companies or a peer set so it can be monitored later
  • Building a comps set: Keeping a group of competitors together for recurring tearsheets and searches
Items must be Knowledge Graph IDs, not company names or tickers. Resolve names, tickers, and themes with find_securities, or exact ISIN, CUSIP, SEDOL, and listing codes with get_securities, before calling this tool.

​
How It Works

  1. Resolve each company or security to its Knowledge Graph ID with find_securities or get_securities
  2. Extract the id field from each result
  3. Call bigdata_create_watchlist with a name, an optional description, and the list of IDs in items
  4. Keep the returned watchlist id for later reads, edits, deletes, and for the Bigdata App

​
Parameters

​
Important Notes

  • A watchlist created through this tool holds at most 100 unique IDs. Watchlists created in the Bigdata App can be larger, and bigdata_get_watchlist still returns all of their items
  • Duplicate IDs are collapsed, so the returned items may be shorter than the list you sent
  • Category, sharing, and global or thematic settings cannot be set through this tool. Manage them in the Bigdata App

​
Data Returned

Returns a JSON object with a watchlists array containing the newly created watchlist:

​
Usage Monitoring

The tool bigdata_create_watchlist does not consume any quota.

​
Practical Tips

​
Next steps after creating

Pass the returned items to bigdata_portfolio_tearsheet for a one-row-per-company grid of price, EPS, price target, and sentiment across the whole watchlist.

​
Larger lists

For lists above 100 securities, create the watchlist with the first 100 IDs and grow it with bigdata_edit_watchlist, or build it in the Bigdata App.