Skip to content
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

Node TESS Search

There is no more direct way to interact with brands than a trademark search. This project lets you interact with brands via JavaScript.

(Work in progress!)

This is a Node.js script that executes a search of TESS, the US Patent and Trademark Office's trademark search system, outputting a JSON array containing result page links (currently useless!) and image URL links (useful for some purposes).

The term should be specified as a "free-form" TESS search term, meaning it can contain things like boolean operators, quoted exact matches, and Design Codes in addition to regular search terms.


  • Ensure that you have Python 2 installed, as this project relies on node-stream-mmmagic, which in turn relies on a native addon module built by node-gyp, which lacks Python 3 support.
    • If you have both Python 2 and Python 3 installed:
      • Make sure npm is configured to use Python 2, e.g.:
        • which python2.7
        • npm config set python PYTHON_2_PATH_FROM_ABOVE
      • Make sure you don't have "python" symlinked to python 3.


Find all trademarks of Freedom™:

node cli.js -t 'freedom[FM]'

Find all trademarks with designs incorporating "costumed small mammals, rodents, kangaroos, wallabies":

node cli.js -t '030926[dc]'

Print help/documentation of flags:

node cli.js

Output Format

    "full": { ... }  // object with fields corresponding to those displayed on TESS


  • Support paging - there is a limit of 500 results until then!
  • Retry any failed document requests
  • Retrieve images
  • Fix logout - not consistently closing session


TESS does not offer an API, this script relies on content scraping. It attempts to be a very well-behaved scraper and, to the best of my knowledge, adheres to TESS's terms of use, but there are all kinds of reasons why it could break at any time, so please do not use this as the foundational technology for your startup.


Node library/CLI to query the TESS trademark search engine



No releases published
You can’t perform that action at this time.