# WIPO API

> WIPO returns trademark records and is available as a workflow and API.

WIPO, also called the Global Brand Database, returns trademark records matched by brand name, with optional office, status, and Nice class inputs.

- Page: https://fous.com/workflows/wipo
- Handle: `@wipo`
- Category: [Legal](https://fous.com/workflows/category/legal)
- Source website: https://branddb.wipo.int
- Last verified: Sep 29, 2026
- Fous is not affiliated with WIPO.

## Methods

### Search trademarks

Operation `search_trademarks`, version 1. 1 credit per call.

Search WIPO Global Brand Database trademarks by brand name, registering office, status and Nice class in relevance order. Status follows the registering office’s reported status; missing record details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `status` | string | no | `"active"` | Record status: active includes registered and pending; inactive includes expired and ended. For example active. |
| `country` | string | no | `"Japan"` | Registering office as a country name or two-letter code, such as Japan, EU, or WIPO. Leave blank for all offices. |
| `brand_name` | string | yes | `"Nutella"` | Brand name to search, for example Nutella. |
| `max_results` | integer | no | `3` | Maximum records to return, such as 25. |
| `product_class` | string | no | `"clothing"` | Nice class number or product words, such as 25 or clothing. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "brand_name"
  ],
  "properties": {
    "status": {
      "enum": [
        "any",
        "active",
        "inactive"
      ],
      "type": "string",
      "default": "active",
      "description": "Record status: active includes registered and pending; inactive includes expired and ended. For example active.",
      "examples": [
        "active"
      ]
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Registering office as a country name or two-letter code, such as Japan, EU, or WIPO. Leave blank for all offices.",
      "examples": [
        "Japan"
      ]
    },
    "brand_name": {
      "type": "string",
      "description": "Brand name to search, for example Nutella.",
      "examples": [
        "Nutella",
        "Adidas"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum records to return, such as 25.",
      "x-fous-developer": true,
      "examples": [
        3,
        2
      ]
    },
    "product_class": {
      "type": "string",
      "default": "",
      "description": "Nice class number or product words, such as 25 or clothing.",
      "examples": [
        "clothing"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "brand_name": "Nutella",
      "max_results": 3
    },
    {
      "status": "active",
      "country": "Japan",
      "brand_name": "Adidas",
      "max_results": 2,
      "product_class": "clothing"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `trademarks` | array |  |  |
| `trademarks[].owner` | string or null | `"FERRERO S.p.A."` |  |
| `trademarks[].office` | string or null | `"New Zealand"` |  |
| `trademarks[].status` | string or null | `"Registered"` |  |
| `trademarks[].classes` | array |  |  |
| `trademarks[].mark_text` | string or null | `"nutella ; nutella"` |  |
| `trademarks[].expiry_date` | string or null | `"2034-03-26"` |  |
| `trademarks[].branddb_link` | string or null | `"https://branddb.wipo.int/en/similarname/brand/NZ501993000225926"` |  |
| `trademarks[].owner_country` | string or null | `"Italy"` |  |
| `trademarks[].mark_image_link` | string or null |  |  |
| `trademarks[].application_date` | string or null | `"1993-03-26"` |  |
| `trademarks[].registration_date` | string or null | `"1996-03-26"` |  |
| `trademarks[].application_number` | string or null | `"225926"` |  |
| `trademarks[].registration_number` | string or null | `"225926"` |  |

**Example input**

```json
{
  "brand_name": "Nutella",
  "max_results": 3
}
```

**Example output**

```json
{
  "trademarks": [
    {
      "owner": "FERRERO S.p.A.",
      "office": "New Zealand",
      "status": "Registered",
      "classes": [
        "30 — Coffee, tea, bread and confectionery"
      ],
      "mark_text": "nutella ; nutella",
      "expiry_date": "2034-03-26",
      "branddb_link": "https://branddb.wipo.int/en/similarname/brand/NZ501993000225926",
      "owner_country": "Italy",
      "mark_image_link": null,
      "application_date": "1993-03-26",
      "registration_date": "1996-03-26",
      "application_number": "225926",
      "registration_number": "225926"
    },
    {
      "owner": "FERRERO S.P.A.",
      "office": "Brazil",
      "status": "Registered",
      "classes": [],
      "mark_text": "NUTELLA",
      "expiry_date": "2025-11-28",
      "branddb_link": "https://branddb.wipo.int/en/similarname/brand/BR500000817073566",
      "owner_country": "Italy",
      "mark_image_link": null,
      "application_date": "1993-02-09",
      "registration_date": "1995-11-28",
      "application_number": "817073566",
      "registration_number": "817073566"
    },
    {
      "owner": "ش. فيريرو اس بي ايه",
      "office": "UAE",
      "status": "Registered",
      "classes": [
        "43 — Food and drink services"
      ],
      "mark_text": "NUTELLA",
      "expiry_date": "2033-06-20",
      "branddb_link": "https://branddb.wipo.int/en/similarname/brand/AE502013000193695",
      "owner_country": "Italy",
      "mark_image_link": null,
      "application_date": "2013-06-20",
      "registration_date": "2014-07-16",
      "application_number": "AE/193695",
      "registration_number": "193695"
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@wipo",
  "visibility": "public",
  "operation": "search_trademarks",
  "version": 1,
  "input": {
    "brand_name": "Nutella",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@wipo\",\n  \"visibility\": \"public\",\n  \"operation\": \"search_trademarks\",\n  \"version\": 1,\n  \"input\": {\n    \"brand_name\": \"Nutella\",\n    \"max_results\": 3\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@wipo",
  "visibility": "public",
  "operation": "search_trademarks",
  "version": 1,
  "input": {
    "brand_name": "Nutella",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@wipo","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Find trademark records matching a brand name
- Review trademark owners and registering offices
- Check reported trademark statuses
- Compare trademarks by Nice class
- Review application and registration dates

## FAQ

### Is Fous affiliated with WIPO?

No. Fous is not affiliated with WIPO. This workflow reads the public branddb.wipo.int website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a WIPO account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from branddb.wipo.int when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### Which trademarks match a brand name?

Search trademarks finds matching records when you provide a brand name.

### Which office registered a trademark?

Search trademarks returns the registering office for matching records.

### Is a trademark active or inactive?

Search trademarks returns the status reported by the registering office.

## Related

- [USPTO API](https://fous.com/workflows/uspto.md): USPTO provides U.S. trademark records, name searches for matching filings, and current status and prosecution history for selected marks.
- [Google Patents API](https://fous.com/workflows/google-patents.md): Google Patents searches public records and provides patent details and company summaries; legal status is estimated, and citations, claims, and company breakdowns have record limits.
- [Open Food Facts API](https://fous.com/workflows/open-food-facts.md): Open Food Facts provides public packaged-food information, including ingredients, allergens, nutrition, and product classifications; coverage varies, and search results favor popular products.
- [Espacenet API](https://fous.com/workflows/espacenet.md): European Patent Office public patent search and family information.
- [Grainger API](https://fous.com/workflows/grainger.md): Industrial and facility supplies with public list prices.
- [UPCitemdb API](https://fous.com/workflows/upcitemdb.md): Find product information and recorded store offers by UPC or EAN barcode.
- [Have I Been Pwned API](https://fous.com/workflows/have-i-been-pwned.md): Find public records of known data breaches.
- [ABN Lookup API](https://fous.com/workflows/abn-lookup.md): Search Australian businesses by name or ABN and check public registration details.
- [All Legal workflows](https://fous.com/workflows/category/legal)