Usage

Basic usage

After installing mets, you can use it from the command line:

mets <search_term> [options]

Options

  • -i, –images: Only return objects with images. Default: True

  • -n, –num: Maximum number of results to return. Default: 80

  • -s, –sort: Sort results by date (0: ascending, 1: descending, other: no sort). Default: 0

  • -o, –output: Output JSON filename. Prints to stdout if not provided.

  • -m, –time: Delay between API requests in seconds. Default: 0.001

  • -d, –download: Download object images

  • -p, –path: Folder to save downloaded images. Default: ‘images’

  • -t, –title: Search in title only

  • -g, –tags: Search in tags only

Example

To search for objects containing “sunflower”, return up to 5 results sorted by date descending, save the output to out.json, and download the associated images:

mets "sunflower" -n 5 -s 1 -o out.json -d

This will create a JSON file named out.json with the search results and download the images to a folder named images in your current directory.