# WIPO Global Brand Database Scraper (`aboo.script/branddb-wipo-int-scraper`) Actor

\[💰$4 / 1K] ⚡ Fast, cheap WIPO Global Brand Database scraper. No login, no API key. Search 55M+ trademarks from ~90 IP offices by brand name or URL, filter by office, status, Nice class: owner, address, attorney, status, dates, goods & services and logo.

- **URL**: https://apify.com/aboo.script/branddb-wipo-int-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 results

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

## WIPO Global Brand Database Scraper

![WIPO Global Brand Database Scraper](https://i.ibb.co/chKnvbcq/branddb-wipo-int-banner.png)

**WIPO Global Brand Database Scraper** extracts trademark records from the [WIPO Global Brand Database](https://branddb.wipo.int/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Global Brand Database search URL or type a few brand names, and get the brand name, logo, owner, representative, status, Nice classes, goods and services, and every filing date for each trademark. No account or login required.

### Introduction

The [WIPO Global Brand Database](https://branddb.wipo.int/) is the free trademark search service of the World Intellectual Property Organization. It brings together more than 55 million trademarks, appellations of origin, and emblems from about 90 national and regional IP offices, including the USPTO, EUIPO, UK IPO, Japan, Korea, and international registrations under the Madrid System. Brand owners, trademark attorneys, and researchers use it to check if a name is already taken and to follow who owns which brand.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from the WIPO Global Brand Database?

- 🏷️ Brand name in every language it was filed in, plus the brand logo image
- 📋 IP office, trademark type, kind of mark, and mark type (word, figurative, combined)
- 🚦 Status (registered, pending, expired, ended) and the office's own status wording
- 📅 Application, registration, publication, expiry, status, and termination dates
- 🔢 Application number, registration number, and WIPO record ID
- 🗂️ Nice classes with the goods and services wording for each class, and Vienna codes for logos
- 🏢 Applicants and owners: name, kind, country, and street address, city, and postal code when the office publishes them
- ⚖️ Representatives (attorneys or agents) and the correspondence contact
- 🌍 Designated countries, priority claims, gazette publications, and the history of events on the file
- 🔗 Direct link to each trademark page on the Global Brand Database

### Use Cases

- 📈 **Trademark clearance**: check if a brand name is already registered or pending in the markets you care about before you launch.
- 🕵️ **Brand monitoring**: follow new filings that look like your brand and spot them while they can still be opposed.
- 🤝 **Lead generation**: build lists of brand owners and trademark attorneys by office, class, or status.
- 🗂️ **Portfolio research**: collect every trademark of a company or a competitor, with renewal and expiry dates.
- 🤖 **AI and automation**: feed clean, structured trademark data into spreadsheets, dashboards, or AI workflows.

### How to scrape the WIPO Global Brand Database step by step

1. Paste one or more Global Brand Database results URLs into **Start URLs**, or type brand names into **Search queries**.
2. Optionally pick **IP offices**, **Status**, **Nice classes**, **Designated countries**, and **Sort by** for your search queries.
3. Set **Maximum number of results** to how many trademarks you want per URL or per query.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Global Brand Database URLs to scrape. Supported pages: results pages of the brand name, quick, advanced, goods and services, and explore searches, and single trademark pages. Every filter you apply on the website (office, status, class, country, dates, sort order, and so on) is kept in the results.
- **Search queries**: brand names to search for, one per line. Each query is scraped separately, the same way as the brand name search on the website.
- **Maximum number of results**: how many trademarks to collect for each start URL or search query. Set 0 to collect everything the site shows for that search.
- **IP offices**: only trademarks filed at these offices, as two-letter codes (for example US, EM for the European Union, WO for international registrations).
- **Status**: only trademarks with these statuses (Registered, Pending, Expired, Ended, Unknown).
- **Nice classes**: only trademarks in these classes of goods and services, numbers from 1 to 45.
- **Designated countries**: only trademarks that are protected in these countries, as two-letter codes.
- **Sort by**: most relevant first, or by application, registration, or expiry date.

The filters apply to search queries only; start URLs keep the filters already in the URL. You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a Global Brand Database results page (registered NIKE trademarks at the USPTO):

```json
{
  "startUrls": [
    {
      "url": "https://branddb.wipo.int/en/similarname/results?sort=score%20desc&rows=30&asStructure=%7B%22boolean%22:%22AND%22,%22bricks%22:%5B%7B%22key%22:%22brandName%22,%22value%22:%22nike%22,%22strategy%22:%22Simple%22%7D%5D%7D&fcstatus=Registered&fcoffice=US"
    }
  ],
  "maxResults": 5
}
```

Search by brand name:

```json
{
  "searchQueries": ["apple"],
  "maxResults": 5,
  "sort": "score desc"
}
```

### Output

Each trademark is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://branddb.wipo.int/en/similarname/brand/EM500000018856319",
  "st13": "EM500000018856319",
  "brandName": "PUMA",
  "brandNames": [{ "languageCode": "en", "text": "PUMA" }],
  "logoUrl": "https://api.apify.com/v2/key-value-stores/0d62d1db-7a67-466a-b86f-79d6a33e71e2/records/logo-EM500000018856319",
  "type": "TRADEMARK",
  "kind": ["Individual"],
  "markFeature": "Figurative",
  "status": "Registered",
  "officeStatus": "Registered",
  "statusDate": "2023-08-25T00:00:00Z",
  "office": "EM",
  "designatedCountries": ["EM"],
  "applicationNumber": "018856319",
  "applicationDate": "2023-03-31T00:00:00Z",
  "registrationNumber": "018856319",
  "registrationDate": "2023-08-24T00:00:00Z",
  "publicationDate": null,
  "expiryDate": "2033-03-31T00:00:00Z",
  "terminationDate": null,
  "applicationLanguageCode": "en",
  "secondLanguageCode": "de",
  "filingPlace": null,
  "niceClasses": [18, 25, 28, 35],
  "goodsAndServices": [
    {
      "niceClass": 18,
      "languageCode": "en",
      "description": "Bags; pouches; carrying bags; travelling bags; all-purpose sports bags; attaché cases; shopping bags; ..."
    },
    {
      "niceClass": 25,
      "languageCode": "en",
      "description": "Clothing; footwear; boot uppers; footwear uppers; inner soles; ..."
    }
  ],
  "viennaCodes": ["03.01.04", "03.01.21", "03.01.24"],
  "applicants": [
    {
      "name": "PUMA SE",
      "kind": "Legal Entity",
      "identifier": "35956",
      "countryCode": "DE",
      "address": "PUMA Way 1",
      "city": "Herzogenaurach",
      "region": null,
      "postalCode": "91074"
    }
  ],
  "representatives": [],
  "correspondent": {
    "name": "PUMA SE",
    "kind": "Legal Entity",
    "identifier": "35956",
    "countryCode": "DE",
    "address": "PUMA Way 1",
    "city": "Herzogenaurach",
    "region": null,
    "postalCode": "91074"
  },
  "priorities": [],
  "publications": [
    { "identifier": "2023/090", "section": "A.1", "date": "2023-05-17T00:00:00Z" },
    { "identifier": "2023/160", "section": "B.1", "date": "2023-08-25T00:00:00Z" }
  ],
  "events": []
}
```

Items from other offices also fill `events` (for example `{ "date": "2006-11-07T00:00:00Z", "officeKind": "REGISTERED-PRINCIPAL REGISTER", "gbdKind": null }`) and `priorities` (`countryCode`, `number`, `date`).

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- The Global Brand Database shows at most 360 results for one search. To collect more, split a broad search into smaller ones with filters such as office, status, Nice class, or country.
- Brand logo search (search by image) pages are not supported; other unsupported URLs are skipped with a warning.
- The data each office publishes differs: some offices give no expiry date, no representative, or no event history, so those fields are `null` or empty.
- Full postal addresses are shown only as images on the website, so `address`, `city`, and `postalCode` are filled only when the office also publishes the address as text.
- When the goods and services wording exists in English, only the English wording is returned; otherwise it is returned in the languages the office published.
- The logo is saved with the run and `logoUrl` links to it; trademarks without a logo (word marks) have `logoUrl` set to `null`.
- Status values follow the database: for example, the USPTO uses Ended instead of Expired.

### Why use the WIPO Global Brand Database Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🌍 **All offices in one place**: national, regional, and international registrations from about 90 IP offices, not just one country.
- 🎯 **Keeps your filters**: paste any results URL from your browser and get exactly what you see there.
- 🧹 **Clean data**: dates use one standard format, classes are numbers, and parties are split into name, country, and address fields.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of results. See **Notes** for the limit set by the Global Brand Database.

#### Do I need a WIPO account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I monitor new trademark filings on a schedule?

Yes. Search a brand name sorted by newest application date and use Apify Schedules to run the actor every day or week, so new filings show up automatically.

#### Why are some fields empty?

Each IP office shares a different set of information with the database. When a field is not available for a trademark, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, brand name searches, and office, status, class, country, and sort filters. If you need other inputs, such as owner name search or date ranges, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [WIPO Global Brand Database](https://branddb.wipo.int/)

# Actor input Schema

## `startUrls` (type: `array`):

WIPO Global Brand Database search results URLs (all filters in the URL are kept) or trademark detail URLs.

## `searchQueries` (type: `array`):

Brand names to search for. Each query is scraped separately and uses the filters below.

## `maxResults` (type: `integer`):

Maximum number of trademarks to scrape per start URL or search query. Set 0 for no limit. The site shows at most 360 results per search, so use filters to split larger searches.

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

Only trademarks filed at these IP offices, as two-letter codes (for example US, EM for the European Union, WO for international registrations). Applies to search queries only.

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

Only trademarks with these statuses. Applies to search queries only.

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

Only trademarks in these Nice classes of goods and services (numbers from 1 to 45, for example 25 for clothing). Applies to search queries only.

## `designations` (type: `array`):

Only trademarks that are protected in these countries, as two-letter codes (for example FR or JP). Applies to search queries only.

## `sort` (type: `string`):

Order of the results. Applies to search queries only.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://branddb.wipo.int/en/similarname/results?sort=score%20desc&rows=30&asStructure=%7B%22boolean%22:%22AND%22,%22bricks%22:%5B%7B%22key%22:%22brandName%22,%22value%22:%22nike%22,%22strategy%22:%22Simple%22%7D%5D%7D&fcstatus=Registered&fcoffice=US"
    }
  ],
  "searchQueries": [
    "apple"
  ],
  "maxResults": 5,
  "sort": "score desc"
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://branddb.wipo.int/en/similarname/results?sort=score%20desc&rows=30&asStructure=%7B%22boolean%22:%22AND%22,%22bricks%22:%5B%7B%22key%22:%22brandName%22,%22value%22:%22nike%22,%22strategy%22:%22Simple%22%7D%5D%7D&fcstatus=Registered&fcoffice=US"
        }
    ],
    "searchQueries": [
        "apple"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/branddb-wipo-int-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 = {
    "startUrls": [{ "url": "https://branddb.wipo.int/en/similarname/results?sort=score%20desc&rows=30&asStructure=%7B%22boolean%22:%22AND%22,%22bricks%22:%5B%7B%22key%22:%22brandName%22,%22value%22:%22nike%22,%22strategy%22:%22Simple%22%7D%5D%7D&fcstatus=Registered&fcoffice=US" }],
    "searchQueries": ["apple"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/branddb-wipo-int-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 '{
  "startUrls": [
    {
      "url": "https://branddb.wipo.int/en/similarname/results?sort=score%20desc&rows=30&asStructure=%7B%22boolean%22:%22AND%22,%22bricks%22:%5B%7B%22key%22:%22brandName%22,%22value%22:%22nike%22,%22strategy%22:%22Simple%22%7D%5D%7D&fcstatus=Registered&fcoffice=US"
    }
  ],
  "searchQueries": [
    "apple"
  ]
}' |
apify call aboo.script/branddb-wipo-int-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/branddb-wipo-int-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/MnKMB43wTaQz8RmRc/builds/3r3WGyWOFlXW9ZIFC/openapi.json
