# EUIPO Trademarks Scraper: 100M+ EU/Global Trademarks via TMview (`dltik/euipo-trademarks-scraper`) Actor

Search 100M+ trademarks from EUIPO + 70 IP offices (USPTO, INPI, DPMA, WIPO Madrid). Filter by Nice class, status, office, date. No API key. $0.01/result.

- **URL**: https://apify.com/dltik/euipo-trademarks-scraper.md
- **Developed by:** [Walid](https://apify.com/dltik) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## EUIPO Trademarks Scraper — 100M+ EU & Global Trademarks (TMview)

⭐ **Bookmark this actor → [apify.com/dltik/euipo-trademarks-scraper](https://apify.com/dltik/euipo-trademarks-scraper)** — Apify ranks by bookmarks, so it directly drives the visibility of this scraper. **One click. No signup beyond your existing Apify account.**

> Scrape **100M+ trademarks from EUIPO and 70+ national IP offices** (USPTO, INPI France, DPMA Germany, WIPO Madrid, JPO Japan, UKIPO, CNIPA China and more) via the **official TMview backend** (`tmdn.org`) operated by the EU Intellectual Property Office. Filter by Nice class, status, office, application date, mark type. **No API key, no OAuth, no monthly quota — $0.01 per trademark, the disruptive sweet spot vs $0.10 elsewhere.**

### ✨ What makes this EUIPO trademarks scraper different

| Feature | This scraper | Other EUIPO scrapers |
|---|:---:|:---:|
| Price per result | **$0.01** | $0.05 - $0.10 |
| Coverage (offices) | **70+ IP offices via TMview** | EUIPO-only |
| Nice classification (multi-class) | ✅ array | partial |
| Mark image URL | ✅ | rare |
| Territories protected (Madrid/EU designations) | ✅ array | ❌ |
| Application + registration + opposition + expiration dates | ✅ all four | partial |
| TMview deep-link per record | ✅ | ❌ |
| No OAuth / no API key | ✅ | varies |
| Success rate (live 30d) | **100%** | varies |

### What can this EUIPO trademark scraper do?

- 🇪🇺 **100M+ live trademarks** indexed by the EU IP Office's TMview (every active EUIPO trademark + 70+ national IP offices including USPTO, INPI, DPMA, WIPO Madrid)
- 🔎 **Multi-criteria search** — name, Nice class, status, office, mark type, application date range
- 🏷️ **Full Nice classification** — every record returns its complete list of Nice classes (1-45) as a sortable array
- 🌍 **Territory coverage** — for international/Madrid marks, lists every designated territory (EU member states, etc.)
- 🖼️ **Mark image URL** — direct link to the figurative or combined mark image on TMview
- 📅 **Complete lifecycle dates** — application, registration, opposition period, expiration
- 🚀 **HTTP-only, no API key** — TMview is a free public service from the EUIPO (Apify datacenter proxy is enabled by default to avoid edge IP filtering)

### What data can you extract per trademark?

| Field | Description |
|---|---|
| `st13` | TMview unique global ID (office code + sequential ID) |
| `application_number` | Office-level application number |
| `registration_number` | Office-level registration number (if registered) |
| `mark_name` | Verbal element of the mark |
| `mark_type` | `Word`, `Figurative`, `Combined`, `3-D`, `Sound`, `Colour`, `Hologram`, `Motion` |
| `office_code` | Two-letter IP office (`EM` = EUIPO, `FR` = INPI, `DE` = DPMA, `US` = USPTO, `WO` = WIPO, ...) |
| `status` | `Registered`, `Filed`, `Application published`, `Application opposed`, `Application refused`, `Expired` |
| `application_date` | YYYY-MM-DD |
| `registration_date` | YYYY-MM-DD |
| `expiration_date` | YYYY-MM-DD |
| `opposition_period_start` | YYYY-MM-DD |
| `opposition_period_end` | YYYY-MM-DD |
| `opposition_deadline` | YYYY-MM-DD |
| `nice_classes` | Array of Nice class numbers (`[9, 38, 41, 42]`) |
| `applicant_name` | Primary applicant (first in list) |
| `applicant_names` | Full list of applicants |
| `territories_protected` | Country codes where the mark is enforced (Madrid + EU) |
| `mark_image_url` | TMview-hosted image URL (figurative/combined marks only) |
| `tmview_url` | Deep link to the public TMview detail page |
| `office_record_url` | Deep link to the originating IP office record |
| `scraped_at` | ISO-8601 UTC timestamp |

### How to scrape EUIPO trademarks in 5 steps

1. **[Create a free Apify account](https://apify.com/sign-up)** — no credit card required
2. **Open [EUIPO Trademarks Scraper](https://apify.com/dltik/euipo-trademarks-scraper)** on Apify Store
3. **Enter `query`** — brand name or keyword (`apple`, `louis vuitton`, `tesla`)
4. **Optionally filter** — `offices=['EM']` for EUIPO only, `niceClasses=[9, 42]` for software/IT, `statuses=['Registered']`
5. **Click Start** — clean JSON in seconds, exportable to CSV / JSON / Excel from the Apify dataset UI

### How much does it cost to scrape EUIPO trademarks?

**PAY_PER_EVENT — $0.01 per trademark result** ($10 per 1,000 results). Failed/empty runs are not charged. **10x cheaper than competing EUIPO scrapers** on the Apify Store.

| Run size | Trademarks | Apify cost | Time |
|---|---|---|---|
| Quick test | 30 | $0.30 | ~5s |
| Standard | 300 | $3.00 | ~30s |
| Deep | 1,000 | $10.00 | ~2min |
| Massive | 5,000 | $50.00 | ~12min |

### Input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `query` | string | — | Brand name / keyword search (required) |
| `offices` | string[] | `[]` (all) | Office codes: `EM`, `FR`, `DE`, `US`, `WO`, `JP`, `UK`, ... |
| `statuses` | string[] | `[]` (all) | `Registered`, `Filed`, `Expired`, `Application published`, ... |
| `niceClasses` | int[] | `[]` (all) | Nice class numbers `1`-`45` |
| `tmTypes` | string[] | `[]` (all) | `Word`, `Figurative`, `Combined`, `3-D`, `Sound`, `Colour` |
| `applicationDateFrom` | string | — | YYYY-MM-DD |
| `applicationDateTo` | string | — | YYYY-MM-DD |
| `pageSize` | integer | 30 | TMview page size (1-200) |
| `maxResults` | integer | 30 | 1-5000 |
| `proxyConfig` | object | datacenter | Apify datacenter proxy enabled by default (TMview blocks bare cloud IPs) |

### Output example

```json
{
  "st13": "EM500000000000753",
  "application_number": "000000753",
  "registration_number": "000000753",
  "mark_name": "APPLE",
  "mark_type": "Word",
  "office_code": "EM",
  "status": "Registered",
  "application_date": "1996-04-01",
  "registration_date": "1999-02-03",
  "expiration_date": "2036-04-01",
  "opposition_period_start": "1998-07-27",
  "opposition_period_end": "1998-10-26",
  "opposition_deadline": "1998-10-26",
  "nice_classes": [9, 16, 38, 41, 42],
  "applicant_name": "Apple Inc.",
  "applicant_names": ["Apple Inc."],
  "territories_protected": ["DE", "FR", "ES", "IT", "BE", "NL", "AT", "PL", "PT", "FI", "SE", "IE", "EM"],
  "mark_image_url": null,
  "tmview_url": "https://www.tmdn.org/tmview/#/tmview/detail/EM500000000000753",
  "office_record_url": "https://www.tmdn.org/EM500000000000753",
  "scraped_at": "2026-06-20T12:32:01Z"
}
````

### Use cases — EUIPO trademark watch & brand monitoring

- 🎯 **Trademark watch services** — daily diff of newly-filed marks matching a watchlist of brand names or visual classes
- ⚖️ **IP attorney prior-art search** — pull every trademark named `X` filed since 1990 across EU + national offices in seconds, ranked by Nice class
- 🛡️ **Brand abuse monitoring** — detect lookalike applications (e.g. `PuMA`, `PUMAR`, `PUUMA`) in your industry's Nice classes before they register
- 📊 **IP analytics dashboards** — aggregate `application_date × office × Nice class` to track filing trends per industry vertical
- 🚨 **Opposition deadline alerts** — surface every mark whose `opposition_period_end` is within the next 60 days to file a timely opposition
- 🧠 **AI-agent IP wedge** — feed structured trademark data into a Claude / GPT agent for natural-language IP research

### Use the EUIPO scraper via API

**Python:**

```python
import requests

run = requests.post(
    "https://api.apify.com/v2/acts/dltik~euipo-trademarks-scraper/run-sync-get-dataset-items",
    headers={"Authorization": "Bearer YOUR_APIFY_TOKEN", "Content-Type": "application/json"},
    json={
        "query": "apple",
        "offices": ["EM", "FR"],
        "statuses": ["Registered"],
        "niceClasses": [9, 42],
        "maxResults": 50
    }
).json()
print(f"Scraped {len(run)} trademarks")
```

**curl:**

```bash
curl -X POST "https://api.apify.com/v2/acts/dltik~euipo-trademarks-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"tesla","offices":["EM"],"niceClasses":[12],"maxResults":100}'
```

### FAQ

**Is this an official EUIPO API?**
TMview (`tmdn.org`) is the official EU Intellectual Property Office trademark search backend, aggregating data from EUIPO + 70 national IP offices. This scraper hits the same public JSON endpoint the official TMview web UI calls. No reverse engineering of HTML, no anti-bot circumvention.

**What's the difference vs the `nexgendata/euipo-esearch-trademarks` actor?**
Three things: (1) **10x cheaper** — $0.01/result vs $0.10. (2) **70+ offices** vs EUIPO-only. (3) **Nice class arrays + territory designations + mark image URL** by default, no extra steps.

**How fresh is the trademark data?**
TMview syncs from each national IP office on weekly-to-monthly cadence. EUIPO marks are usually within 24h. Smaller offices (e.g. some Nordic + smaller Asian offices) may lag 2-4 weeks for very recent (<30d) filings.

**Does it return goods & services descriptions?**
The search endpoint returns Nice classes (the numeric goods/services categories, 1-45) for every mark. Full per-class descriptive text is per-office and not exposed by the TMview search endpoint — request it once the application\_number is known via the originating office's own scraper (e.g. an EUIPO eSearch wrapper).

**Will TMview rate-limit my runs?**
TMview has a soft ~3-5 req/s limit. We pace requests with a quarter-second sleep between pages and exponential backoff on 429. At default page size 30, 1000 trademarks = ~33 requests, well under the cap. Datacenter proxy is enabled by default since TMview blocks unrouted cloud IPs at the network edge.

***

⭐ **Found this EUIPO Trademarks Scraper useful? [Bookmark it](https://apify.com/dltik/euipo-trademarks-scraper)** — Apify ranks actors by bookmarks, so it's the strongest single signal for Store visibility. One click.

### Other scrapers by dltik

| Actor | What it does | Price |
|---|---|---|
| [Espacenet Patents Scraper](https://apify.com/dltik/espacenet-patents-scraper) | 130M patents from EPO (Espacenet) | $0.015/patent |
| [USPTO Patents Scraper](https://apify.com/dltik/uspto-patents-scraper) | US patents via PatentsView | $0.01/patent |
| [Pappers Sirene Scraper](https://apify.com/dltik/pappers-sirene-scraper) | 26M French companies (SIREN/SIRET) | $0.001/result |
| [BODACC Scraper](https://apify.com/dltik/bodacc-fr-scraper) | French commercial court announcements | $0.003/record |
| [SEC EDGAR MCP Server](https://apify.com/dltik/mcp-server-sec-edgar) | US public companies for AI agents | $0.01/tool-call |
| [TED Europa Scraper](https://apify.com/dltik/ted-europa-scraper) | EU public procurement tenders | $0.005/tender |
| [EUR-Lex Scraper](https://apify.com/dltik/eur-lex-scraper) | EU legislation full text | $0.005/doc |
| [Pappers MCP Server](https://apify.com/dltik/mcp-server-pappers) | French company data for Claude / GPT | $0.01/tool-call |

License: MIT · Author: [dltik](https://apify.com/dltik)

# Actor input Schema

## `query` (type: `string`):

Free-text search on trademark name. Examples: 'apple', 'louis vuitton', 'tesla', 'volkswagen'. Required to run a search.

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

Two-letter IP office codes. Examples: 'EM' = EUIPO (EU trademark), 'FR' = INPI France, 'DE' = DPMA Germany, 'US' = USPTO, 'WO' = WIPO Madrid, 'JP' = JPO Japan. Leave empty to search ALL 70+ offices. Multi-value supported.

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

Filter by status. Common values: 'Registered', 'Filed', 'Expired', 'Application published', 'Application opposed', 'Application refused'. Leave empty for all statuses.

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

Nice classification numbers (1-45) — international trademark goods/services categories. Provide as strings: '9' = electronics/software, '25' = clothing, '35' = advertising, '41' = education, '42' = scientific/IT services. Multi-value supported.

## `tmTypes` (type: `array`):

Filter by mark type. Common values: 'Word', 'Figurative', 'Combined', '3-D', 'Sound', 'Colour', 'Hologram', 'Motion'. Leave empty for all types.

## `applicationDateFrom` (type: `string`):

Filter by application date (start). Format: YYYY-MM-DD. Example: '2020-01-01'. Requires applicationDateTo to be set as well.

## `applicationDateTo` (type: `string`):

Filter by application date (end). Format: YYYY-MM-DD. Example: '2026-12-31'. Requires applicationDateFrom to be set as well.

## `pageSize` (type: `integer`):

Results per TMview page. Default 30 matches the official TMview UI. Higher reduces request count for large maxResults.

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

Maximum trademarks to return. Start with 30 to validate filters, scale up once happy. Billing is per result returned.

## `proxyConfig` (type: `object`):

Apify datacenter proxy is enabled by default — TMview blocks plain cloud IPs at the network edge. You can switch to residential if you scrape at very high frequency.

## Actor input object example

```json
{
  "offices": [],
  "statuses": [],
  "niceClasses": [],
  "tmTypes": [],
  "pageSize": 30,
  "maxResults": 30,
  "proxyConfig": {
    "useApifyProxy": true
  }
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("dltik/euipo-trademarks-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("dltik/euipo-trademarks-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call dltik/euipo-trademarks-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dltik/euipo-trademarks-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "EUIPO Trademarks Scraper: 100M+ EU/Global Trademarks via TMview",
        "description": "Search 100M+ trademarks from EUIPO + 70 IP offices (USPTO, INPI, DPMA, WIPO Madrid). Filter by Nice class, status, office, date. No API key. $0.01/result.",
        "version": "0.0",
        "x-build-id": "6rmKEkXGSZjIePP0J"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dltik~euipo-trademarks-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dltik-euipo-trademarks-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/dltik~euipo-trademarks-scraper/runs": {
            "post": {
                "operationId": "runs-sync-dltik-euipo-trademarks-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/dltik~euipo-trademarks-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-dltik-euipo-trademarks-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "title": "Search query (brand name or keyword)",
                        "type": "string",
                        "description": "Free-text search on trademark name. Examples: 'apple', 'louis vuitton', 'tesla', 'volkswagen'. Required to run a search."
                    },
                    "offices": {
                        "title": "Offices (filter)",
                        "type": "array",
                        "description": "Two-letter IP office codes. Examples: 'EM' = EUIPO (EU trademark), 'FR' = INPI France, 'DE' = DPMA Germany, 'US' = USPTO, 'WO' = WIPO Madrid, 'JP' = JPO Japan. Leave empty to search ALL 70+ offices. Multi-value supported.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "statuses": {
                        "title": "Trademark statuses (filter)",
                        "type": "array",
                        "description": "Filter by status. Common values: 'Registered', 'Filed', 'Expired', 'Application published', 'Application opposed', 'Application refused'. Leave empty for all statuses.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "niceClasses": {
                        "title": "Nice classes (filter)",
                        "type": "array",
                        "description": "Nice classification numbers (1-45) — international trademark goods/services categories. Provide as strings: '9' = electronics/software, '25' = clothing, '35' = advertising, '41' = education, '42' = scientific/IT services. Multi-value supported.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "tmTypes": {
                        "title": "Trademark types (filter)",
                        "type": "array",
                        "description": "Filter by mark type. Common values: 'Word', 'Figurative', 'Combined', '3-D', 'Sound', 'Colour', 'Hologram', 'Motion'. Leave empty for all types.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "applicationDateFrom": {
                        "title": "Application date from",
                        "type": "string",
                        "description": "Filter by application date (start). Format: YYYY-MM-DD. Example: '2020-01-01'. Requires applicationDateTo to be set as well."
                    },
                    "applicationDateTo": {
                        "title": "Application date to",
                        "type": "string",
                        "description": "Filter by application date (end). Format: YYYY-MM-DD. Example: '2026-12-31'. Requires applicationDateFrom to be set as well."
                    },
                    "pageSize": {
                        "title": "Page size",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Results per TMview page. Default 30 matches the official TMview UI. Higher reduces request count for large maxResults.",
                        "default": 30
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum trademarks to return. Start with 30 to validate filters, scale up once happy. Billing is per result returned.",
                        "default": 30
                    },
                    "proxyConfig": {
                        "title": "Proxy (recommended)",
                        "type": "object",
                        "description": "Apify datacenter proxy is enabled by default — TMview blocks plain cloud IPs at the network edge. You can switch to residential if you scrape at very high frequency.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
