Search Goods Services
search_goods_servicesFull-text search over the goods and services identifications of 14M USPTO marks, for questions such as which other owners claim a product in their goods (competitive landscape, descriptiveness or crowded-field evidence, identification drafting precedent). Keyword-based: the query is tokenized and matched against each mark's indexed goods keywords (match_mode all requires every keyword, any requires at least one). Rows include a short excerpt around the matched clause, not the full identification. mode=count returns how many marks claim the goods, with class and status breakdowns; mode=top_owners ranks the owners claiming them; neither returns rows. Searches goods and services text, not mark names; run_knockout_search and search_trademarks search mark names.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | list_marks returns rows; count returns totals + class/status breakdowns only; top_owners ranks owners by matching-mark count. | list_marks |
| sort | No | relevance | |
| text | Yes | Goods/services text to search for (e.g. "anti-tarnish", "vegan leather handbags"). Words of 3+ characters are matched as keywords. | |
| limit | No | Max rows for list_marks mode (default 20). | |
| match_mode | No | all = every keyword must appear in the recitation (default); any = at least one. | all |
| nice_classes | No | Optional Nice class filter (e.g. [14] or ["014"]). | |
| status_filter | No | live = Registered + Pending; dead = Cancelled/Abandoned/Expired. | all |
| owner_contains | No | Optional: only marks whose owner name contains this text. |