# Trademark Search Scraper: TMview, USPTO, WIPO, EUIPO (`themineworks/trademark-search-scraper`) Actor

Search trademarks across TMview's 77 offices (EUIPO, USPTO, WIPO Madrid, UK, Germany, Canada, Japan and more) by mark name, owner or application number: owner, Nice classes, status, filing, registration and expiry dates, opposition deadline. No login.

- **URL**: https://apify.com/themineworks/trademark-search-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.40 / 1,000 trademarks

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Trademark Search Scraper: TMview, USPTO, WIPO, EUIPO

[![Trademarks from 77 offices with owner, classes, status and deadlines in seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/trademark-search-scraper-hero.png)](https://console.apify.com/actors/hJJLeEmQcHTz1HwZM/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns trademarks from TMview, the EU IP Office's search across 77 registers (EUIPO, USPTO, WIPO Madrid, UK, Germany, France, Canada, Australia, Japan, China, Brazil and more), one row per mark with owner, Nice classes, status, filing, registration and expiry dates and the opposition deadline. Search by mark name, owner name or application number, or list every new filing in a date range. No login, no cookies, no API key. You pay $9.00 per 1,000 trademarks on the Free plan and $5.40 per 1,000 on the Gold plan, plus a $0.003 start fee per run.

From **The Mine Works**, with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. Mark, owner and application number search, four match types (contains, whole word, exact, fuzzy), filters for office, Nice class, status, mark type, filing dates and marks open for opposition today, one flat row per mark. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Three registers buyers ask for, in one search.** TMview carries the USPTO (13.5 million US marks, current to the last two days), WIPO Madrid (1.5 million international registrations) and EUIPO (2.8 million EU trademarks, current to the day), plus 74 national and regional offices: about 143 million marks in all. One input, one row shape for every office.
- **The dates that matter, worked out for you.** Every row has the expiry date and `days_until_expiry`, and for applications in their opposition period the deadline, `opposition_open` and `opposition_days_left`. Sort a portfolio by renewal or a watch list by days left to oppose without date maths.
- **Pay per mark, nothing for errors.** Error rows, the summary row and a mark found by two searches in one run are never charged. No TMview account, cookies or API key.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/hJJLeEmQcHTz1HwZM/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Company and business data family:** [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [EU VAT Checker (VIES)](https://apify.com/themineworks/eu-vat-vies-validator?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Tech Stack Detector](https://apify.com/themineworks/tech-stack-detector?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns up to 50 marks that contain "nivara" across all 77 offices:

```json
{
  "searchTerms": ["nivara"],
  "maxItems": 50
}
```

#### Copy to your AI assistant

```text
Run the Apify actor themineworks/trademark-search-scraper with {"searchTerms": ["<brand>"], "matchType": "word", "offices": ["EM", "US", "WO"]} and list each mark with its owner, Nice classes, status and expiry date.
```

### Key features

- Search by mark name, owner name or application number; many of each in one run.
- Four match types: `contains`, `word` (whole word), `exact` and `fuzzy` (similar spellings, for clearance checks).
- Filters: offices, protected territories, Nice classes 1 to 45, status (Filed, Registered, Ended, Expired), mark type, filing date range, only marks open for opposition today.
- New filings watch: leave the name empty, set `filedFrom` to `7 days` and pick offices and classes.
- Sort by TMview relevance or by filing date, newest or oldest first.
- Up to 10,000 marks per search (TMview's own limit), 100 per request.
- Mark image and thumbnail links, the office record link and the TMview link on every row.

### How to use it

#### Brand clearance: is my name taken in my classes?

```json
{
  "searchTerms": ["lumen"],
  "matchType": "fuzzy",
  "niceClasses": ["14", "35"],
  "offices": ["EM", "US", "WO", "GB", "IN"],
  "statuses": ["Filed", "Registered"],
  "maxItems": 500
}
```

#### A competitor's portfolio

```json
{
  "owners": ["Nike Innovate"],
  "offices": ["EM", "US"],
  "statuses": ["Registered"],
  "maxItems": 2000
}
```

#### New EU filings in your classes this week (lead lists for IP firms)

```json
{
  "filedFrom": "7 days",
  "offices": ["EM"],
  "niceClasses": ["14"],
  "sortBy": "newest",
  "maxItems": 1000
}
```

#### Filings you can still oppose

```json
{
  "searchTerms": ["nivara"],
  "matchType": "fuzzy",
  "onlyOpposable": true,
  "maxItems": 200
}
```

#### Look up application numbers

```json
{
  "applicationNumbers": ["019109406", "88831783"]
}
```

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `searchTerms` | list | | Mark names; each is one search |
| `matchType` | text | `contains` | `contains`, `word`, `exact` or `fuzzy` |
| `owners` | list | | Owner (applicant) names; each is one search |
| `applicationNumbers` | list | | Application numbers to look up |
| `offices` | list | all | Two letter office codes: EM, US, WO, GB, DE, FR, CA, AU, JP, CN, IN... |
| `protectedIn` | list | all | Keep marks protected in these countries |
| `niceClasses` | list | all | Nice classes 1 to 45 |
| `statuses` | list | all | Filed, Registered, Ended, Expired |
| `markTypes` | list | all | Word, Figurative, Combined, 3-D, Sound, Colour... |
| `filedFrom` / `filedTo` | date | | YYYY-MM-DD; `filedFrom` also takes `7 days`, `3 months` |
| `onlyOpposable` | yes/no | no | Only marks whose opposition period runs today |
| `sortBy` | text | `relevance` | `relevance`, `newest`, `oldest` |
| `maxItems` | number | 100 | Marks per search, 1 to 10,000 |
| `proxyConfiguration` | proxy | Apify datacenter proxy | A new IP for each retry; the default is enough |

Give at least one mark name, owner, number or a `filedFrom` date.

### What data do you get?

| Field | Example |
|---|---|
| `trademark_id` | EM500000019109406 (TMview id, stable across runs) |
| `mark_name` | NIVARA |
| `office_code`, `office_name` | EM, EUIPO (European Union) |
| `application_number`, `registration_number` | 019109406 |
| `status`, `is_live` | Registered, true |
| `mark_type` | Word |
| `nice_classes` | \[9, 42] |
| `vienna_codes` | \["25.01.15"] for logo marks |
| `owner_name`, `owner_names` | Nike, Inc. |
| `protected_in` | \["EM"] |
| `application_date`, `registration_date`, `expiry_date` | 2024-11-21 |
| `days_until_expiry` | 3297 |
| `opposition_period_start`, `opposition_deadline` | 2026-09-10, 2026-11-11 |
| `opposition_open`, `opposition_days_left` | true, 9 |
| `image_url`, `thumbnail_url` | mark image links |
| `office_record_url`, `tmview_url` | record links |
| `search_query`, `search_type`, `match_type`, `position`, `total_results` | which search found it |
| `scraped_at` | ISO time |

Fields an office does not publish are left out of that row, never guessed. A summary row (`_type: summary`) closes each run with searches read, marks delivered and the reason for any shortfall; it is never charged.

#### Output example

```json
{
  "trademark_id": "MA500000200306957",
  "mark_name": "NIVARA",
  "office_code": "MA",
  "office_name": "Morocco",
  "application_number": "306957",
  "registration_number": "306957",
  "status": "Filed",
  "is_live": true,
  "mark_type": "Word",
  "nice_classes": [30],
  "owner_name": "STE WALILI FOOD \"WF\"",
  "owner_names": ["STE WALILI FOOD \"WF\""],
  "protected_in": ["MA"],
  "application_date": "2026-08-14",
  "opposition_period_start": "2026-09-10",
  "opposition_deadline": "2026-11-11",
  "opposition_open": false,
  "office_record_url": "http://tmview.ompic.ma/trademark/data/MA500000200306957",
  "tmview_url": "https://www.tmdn.org/tmview/#/tmview/detail/MA500000200306957",
  "search_query": "nivara",
  "search_type": "mark",
  "match_type": "contains",
  "position": 2,
  "total_results": 103
}
```

### Pricing

Pay per event: you pay for the marks you receive, plus a flat $0.003 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `trademark-scraped` | Once per mark row stored in your dataset | $9.00 per 1,000 | $8.00 per 1,000 | $6.75 per 1,000 | $5.40 per 1,000 |
| `run-start` | Once per run, after the first page returned marks | $0.003 | $0.003 | $0.003 | $0.003 |

Never charged:

- searches TMview has no marks for, and inputs it refuses (each gets an error or info row);
- a mark that a second search of the same run finds again;
- marks past your `maxItems` or past the run's max cost;
- the summary row.

### How it compares

| | This actor | dltik/euipo-trademarks-scraper | automation-lab/euipo-tmview-trademarks-scraper | scrapers_lat/tmview-global-trademarks-scraper |
|---|---|---|---|---|
| Offices | 77 via TMview, incl. USPTO and WIPO | 70+ via TMview | TMview | 77 via TMview |
| Search by owner | Yes | Yes | Not listed | Yes |
| Application number lookup | Yes | Yes | Not listed | Not listed |
| Opposition deadline and days left | Yes, every row | Yes | With details | With enrichment |
| Expiry date | Yes, every row | With details ($0.01 extra) | With details | Yes |
| Price per 1,000 marks | $9.00 Free, $5.40 Gold | $10.00 plus $10.00 for details | about $0.04 plus $0.005 start | $15.00 Free, $13.00 Gold |

Checked 12 Nov 2026 from the public Store listings.

### Run it on a schedule

Save an input as a Task and schedule it daily or weekly: a `filedFrom` of `7 days` with your offices and classes gives a weekly feed of new filings, and `onlyOpposable` with your brand names in `fuzzy` mode gives a watch list of marks you may want to oppose. Connect the dataset to Google Sheets, Slack or a webhook to get the new rows.

### FAQ

#### What does this actor read?

The public search behind TMview (tmdn.org), the free register search run by the European Union Intellectual Property Office with 77 participating offices. It reads the same results the TMview website shows.

#### Do I need an account, cookies or an API key?

No. No TMview account, no cookies and no API key.

#### Does it cover the USPTO and WIPO?

Yes. The USPTO (office code US) and the WIPO Madrid register (WO) are TMview offices, so US and international marks come back in the same row shape as EU marks.

#### How many marks can I get?

Up to 10,000 per search, which is the most TMview serves for one query. To go further, split by office, Nice class or filing date range; each split is its own search.

#### Why are some fields empty?

Each office publishes a different set of data to TMview. Registration numbers, expiry dates and opposition periods are only present where the office provides them. Logo marks often have no `mark_name`. India's records in TMview stop at 2022, so newer Indian filings are not in the results.

#### What do the match types do?

`contains` finds the name anywhere in the mark, `word` only as a whole word, `exact` only marks that are exactly the name, and `fuzzy` also finds similar spellings, which is what a clearance check needs. On "nike", contains found about 15,900 marks, word 3,200, exact 1,300 and fuzzy 95,000.

#### Are goods and services texts, representatives and owner addresses included?

Not in this release; rows carry the Nice class numbers and owner names. Tell us in the Issues tab if you need the full wording.

#### How long does a run take?

About one second per 100 marks. The 50 mark example takes a few seconds plus the container start.

#### Which formats can I download?

JSON, CSV, Excel, XML and HTML from the dataset, or through the Apify API.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes. Every Store actor can be called through mcp.apify.com; add `themineworks/trademark-search-scraper` as a tool and ask in plain words.

#### Is it legal to scrape TMview?

TMview is a free public register search, and trademark registers are public by law so that anyone can check what is protected. The actor reads only public records, without logging in. Owner names on marks can include people; collect only what you need and follow the data protection rules that apply to you. This is not legal advice.

### Integrations

Use the Apify API, the JavaScript or Python client, Make, Zapier, n8n, Google Sheets or webhooks to send the rows where you need them.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [EU VAT Checker (VIES)](https://apify.com/themineworks/eu-vat-vies-validator?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Tech Stack Detector](https://apify.com/themineworks/tech-stack-detector?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Bundesanzeiger Scraper](https://apify.com/themineworks/germany-bundesanzeiger-monitor?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Domain to LinkedIn URL Resolver](https://apify.com/themineworks/domain-to-linkedin-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [World Bank Trade Scraper](https://apify.com/themineworks/global-trade-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [US Import Records](https://apify.com/themineworks/us-import-supplier-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Y Combinator Scraper](https://apify.com/themineworks/y-combinator-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Norway Company Register](https://apify.com/themineworks/norway-brreg-entity-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that returns fewer marks than TMview shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search trademarks across EUIPO, USPTO, WIPO and 74 more offices and get every mark back as one row, with owner, classes, status, expiry and opposition deadline, no login.*

# Actor input Schema

## `searchTerms` (type: `array`):

Brand or mark names to search, one per line. Each name is one search. Example: nivara, just do it, lumen.

## `matchType` (type: `string`):

contains: the name appears anywhere in the mark (NIVARA finds NIVARA JEWELS). word: the name is a whole word of the mark. exact: the mark is exactly the name. fuzzy: similar spellings too (for clearance checks; returns many more marks).

## `owners` (type: `array`):

Applicant or owner names, one per line, to list every mark a company holds. Example: Nike Innovate, Tata Sons. Each owner is one search; the filters below apply too.

## `applicationNumbers` (type: `array`):

Application numbers to look up, one per line, as the office writes them. Example: 019109406 (EUIPO) or 88831783 (USPTO). Add the office in Offices if a number exists at several offices. Only the Offices filter applies to number lookups.

## `offices` (type: `array`):

Two letter office codes, one per line. Empty means all 77 offices. EM = EUIPO (EU trademarks), US = USPTO, WO = WIPO Madrid, GB = UK, DE = Germany, FR = France, ES = Spain, IT = Italy, CH = Switzerland, CA = Canada, AU = Australia, JP = Japan, KR = Korea, CN = China, IN = India, MX = Mexico, BR = Brazil, TR = Turkiye.

## `protectedIn` (type: `array`):

Keep only marks protected in these countries or regions, two letter codes, one per line. Useful with WIPO Madrid marks, which list the countries they cover. Example: IN, US, EM.

## `niceClasses` (type: `array`):

Nice class numbers 1 to 45, one per line. A mark matches if it covers any of them. Example: 14 (jewellery), 25 (clothing), 9 (software), 35 (retail), 42 (IT services).

## `statuses` (type: `array`):

Keep only marks with these statuses. Empty means all. Filed covers pending, published and opposed applications.

## `markTypes` (type: `array`):

Keep only these mark types. Empty means all.

## `filedFrom` (type: `string`):

Only marks filed on or after this date. YYYY-MM-DD, or a relative value like 7 days, 3 months. With no mark name, owner or number, this lists every new filing in the range (combine with Offices and Nice classes for a filing watch).

## `filedTo` (type: `string`):

Only marks filed on or before this date. YYYY-MM-DD.

## `onlyOpposable` (type: `boolean`):

On: only applications whose opposition period is running today, at offices that publish one. Use it to catch filings you may want to oppose.

## `sortBy` (type: `string`):

relevance is TMview's own order. newest puts the latest filings first.

## `maxItems` (type: `integer`):

The most marks to return for each name, owner, number or date search, 1 to 10,000. TMview serves at most 10,000 marks per search; narrow with offices, classes or dates to go further.

## `proxyConfiguration` (type: `object`):

TMview requests go out through this proxy, a new IP for each retry; the last retry goes out directly. The default Apify datacenter proxy is enough. Turn the proxy off to send every request directly.

## Actor input object example

```json
{
  "searchTerms": [
    "nivara"
  ],
  "matchType": "contains",
  "onlyOpposable": false,
  "sortBy": "relevance",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "nivara"
    ],
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/trademark-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["nivara"],
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/trademark-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "nivara"
  ],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/trademark-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/trademark-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hJJLeEmQcHTz1HwZM/builds/sxb95EgzCNSH4EGbc/openapi.json
