# Google Marcas e Patentes Scraper API Brasil (`brasildados/google-marcas-patentes-scraper-api`) Actor

Pesquise no Google Patents patentes ligadas a marcas, empresas, inventores e tecnologias com foco no Brasil. Filtre por país, situação e tipo; exporte título, resumo, titular, inventor, número, datas, PDF e miniatura em JSON, CSV ou Excel para inovação, concorrência e pesquisa tecnológica.

- **URL**: https://apify.com/brasildados/google-marcas-patentes-scraper-api.md
- **Developed by:** [BrasilDados.org - Hub de APIs de Dados do Brasil](https://apify.com/brasildados) (community)
- **Categories:** Business, Developer tools, Education
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$40.00 / 1,000 por marca listadas

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### Google Marcas e Patentes Scraper API Brasil

Pesquise no Google Patents patentes e pedidos relacionados a marcas, empresas, tecnologias, titulares, inventores ou números de publicação, com foco no mercado brasileiro. O Actor oferece toda a experiência em português do Brasil, usa `BR` como país inicial, pagina automaticamente e entrega uma linha por documento para análise de inovação, concorrentes, liberdade de operação e propriedade industrial no Brasil.

> Este Actor pesquisa patentes e desenhos industriais. Ele não consulta marcas registradas no INPI e não substitui uma busca oficial ou análise jurídica de propriedade industrial.

### Principais usos

- Encontrar patentes associadas a uma empresa ou nome comercial.
- Acompanhar tecnologias, produtos e concorrentes.
- Pesquisar inventores e titulares.
- Levantar pedidos recentes ou patentes concedidas.
- Exportar resultados para JSON, CSV e Excel.

### Como usar

1. Informe uma ou várias consultas.
2. Escolha relevância, mais recentes ou mais antigas.
3. Opcionalmente, filtre por países, idiomas, situação e tipo.
4. Defina o máximo de resultados por consulta.
5. Execute e abra o Dataset.

```json
{
  "queries": ["painel solar", "bateria de lítio"],
  "sort": "relevance",
  "countries": ["BR"],
  "languages": ["pt-BR"],
  "status": "ALL",
  "type": "ALL",
  "maxResultsPerQuery": 50
}
```

Os códigos de países e escritórios usam duas letras, como `BR`, `US`, `WO` e `EP`. Uma lista vazia pesquisa todos os países disponíveis.
O filtro opcional `languages` aceita `pt-BR` (Português do Brasil, pré-selecionado), `en` (Inglês) e `ALL` (Todos os idiomas). Quando `ALL` for selecionado, nenhum filtro de idioma será enviado; se vier combinado com outra opção, `ALL` prevalece.

### Dados entregues

Cada resultado contém posição geral e por consulta, posição original, número de publicação, título, resumo, URL pública, titular, inventor, datas de prioridade, depósito, concessão e publicação, idioma real do documento, países selecionados, PDF, miniatura, consulta, ordenação e data da coleta.

| Campo               | Descrição                                                 |
| ------------------- | --------------------------------------------------------- |
| `resultPosition`    | Posição sequencial do item na saída completa.             |
| `queryPosition`     | Posição do item dentro do termo pesquisado.               |
| `sourcePosition`    | Posição original informada pela fonte, quando disponível. |
| `publicationNumber` | Número público da patente ou do pedido.                   |
| `title`             | Título do documento.                                      |
| `abstract`          | Resumo da invenção, quando disponível.                    |
| `patentUrl`         | URL pública do documento no Google Patents.               |
| `assignee`          | Titular ou depositante informado.                         |
| `inventor`          | Inventor informado.                                       |
| `priorityDate`      | Data de prioridade em formato ISO.                        |
| `filingDate`        | Data de depósito em formato ISO.                          |
| `grantDate`         | Data de concessão em formato ISO, quando aplicável.       |
| `publicationDate`   | Data de publicação em formato ISO.                        |
| `language`          | Idioma informado para o documento.                        |
| `countries`         | Países ou escritórios selecionados na pesquisa.           |
| `pdfUrl`            | URL do PDF público, quando disponível.                    |
| `thumbnailUrl`      | URL da miniatura, quando disponível.                      |
| `query`             | Termo que originou o resultado.                           |
| `sort`              | Ordenação aplicada à pesquisa.                            |
| `collectedAt`       | Data e hora UTC da coleta em ISO 8601.                    |

Exemplo completo de uma linha do Dataset:

```json
{
  "resultPosition": 1,
  "queryPosition": 1,
  "sourcePosition": 1,
  "publicationNumber": "BR102024000001A2",
  "title": "Sistema de geração de energia solar",
  "abstract": "Sistema para conversão e gerenciamento de energia solar.",
  "patentUrl": "https://patents.google.com/patent/BR102024000001A2/pt",
  "assignee": "Empresa Exemplo S.A.",
  "inventor": "Ana Silva",
  "priorityDate": "2023-01-10",
  "filingDate": "2024-01-10",
  "grantDate": null,
  "publicationDate": "2025-07-15",
  "language": "Portuguese",
  "countries": ["BR"],
  "pdfUrl": "https://patentimages.storage.googleapis.com/example/document.pdf",
  "thumbnailUrl": "https://patentimages.storage.googleapis.com/example/thumbnail.png",
  "query": "placa solar",
  "sort": "relevance",
  "collectedAt": "2026-08-14T12:00:00.000Z"
}
```

Campos que não estiverem disponíveis retornam `null` ou listas vazias. O filtro de países limita os documentos pesquisados aos países ou escritórios selecionados e não constitui parecer sobre validade jurídica, manutenção, escopo ou liberdade de operação.

### Usar pela API da Apify

Envie o JSON de entrada para a API da Apify. A execução retorna diretamente as linhas do Dataset, prontas para usar em sua aplicação.

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~google-marcas-patentes-scraper-api/run-sync-get-dataset-items?build=latest" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["painel solar","bateria de lítio"],"countries":["BR"],"languages":["pt-BR"],"maxResultsPerQuery":2}'
```

### Preço

A cobrança é feita por patente ou pedido efetivamente entregue. Duplicados, registros inválidos e buscas sem resultado não geram itens no Dataset. O custo máximo pode ser estimado multiplicando o número de consultas por `maxResultsPerQuery` e pelo preço atual exibido na Apify.

Por exemplo, duas consultas com `maxResultsPerQuery: 50` podem entregar e cobrar no máximo 100 itens. Multiplique essa quantidade pelo preço vigente antes de executar.

### Limitações

- Os resultados dependem da indexação e dos dados exibidos pelo Google Patents.
- Nem todos os documentos oferecem PDF, miniatura, resumo ou todas as datas.
- A situação jurídica de cada documento pode exigir verificação no escritório oficial correspondente.
- A busca não consulta a base de marcas do INPI.
- O Actor não abre individualmente os documentos nem executa análise jurídica.
- Contagens totais da pesquisa podem ser estimativas e a disponibilidade real de páginas pode ser menor.

### Perguntas frequentes

#### Posso procurar patentes de uma marca ou empresa?

Sim. Pesquise o nome no campo de consultas. O resultado pode localizar documentos cujo texto, titular ou metadados correspondam ao termo, mas isso não equivale a uma busca de registro de marca.

#### Posso pesquisar somente documentos brasileiros?

Sim. Use `countries: ["BR"]`.

#### Qual é a diferença entre pedido e patente concedida?

Use `APPLICATION` para pedidos e `GRANT` para documentos concedidos. `ALL` inclui ambos.

#### O resultado confirma que posso usar uma invenção?

Não. Uma análise de liberdade de operação depende de reivindicações, família, território, vigência e avaliação profissional.

#### Preciso fornecer uma chave de outra API?

Não. Para usar a API Batch, o usuário fornece somente o próprio token da Apify. Nunca inclua outras credenciais no input.

### Suporte

Para relatar um problema, envie o ID da execução, o input sem credenciais e uma descrição objetiva pela aba **Issues**. Nunca envie tokens ou chaves privadas.

# Actor input Schema

## `queries` (type: `array`):

Pesquise marcas, empresas, tecnologias, inventores ou números de publicação. Adicione um termo por campo.

## `countries` (type: `array`):

Opcional. Selecione um ou mais países ou escritórios de patentes. Brasil já vem selecionado.

## `languages` (type: `array`):

Opcional. Português (Brasil) já vem selecionado. Escolha Inglês ou Todos os idiomas quando necessário.

## `status` (type: `string`):

Opcional. Consulte todas as situações ou limite a documentos concedidos ou pedidos.

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

Opcional. Consulte todos os tipos ou limite a patentes ou desenhos industriais.

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

Opcional. Ordene por relevância, data mais recente ou data mais antiga.

## `maxResultsPerQuery` (type: `integer`):

Opcional. Quantidade máxima de patentes ou pedidos entregues e cobrados para cada termo.

## Actor input object example

```json
{
  "queries": [
    "placa solar",
    "gerador de energia"
  ],
  "countries": [
    "BR"
  ],
  "languages": [
    "pt-BR"
  ],
  "status": "ALL",
  "type": "ALL",
  "sort": "relevance",
  "maxResultsPerQuery": 50
}
```

# Actor output Schema

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

Dataset com uma linha por patente ou pedido encontrado.

# 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 = {
    "queries": [
        "placa solar",
        "gerador de energia"
    ],
    "countries": [
        "BR"
    ],
    "languages": [
        "pt-BR"
    ],
    "status": "ALL",
    "type": "ALL",
    "sort": "relevance",
    "maxResultsPerQuery": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/google-marcas-patentes-scraper-api").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 = {
    "queries": [
        "placa solar",
        "gerador de energia",
    ],
    "countries": ["BR"],
    "languages": ["pt-BR"],
    "status": "ALL",
    "type": "ALL",
    "sort": "relevance",
    "maxResultsPerQuery": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/google-marcas-patentes-scraper-api").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 '{
  "queries": [
    "placa solar",
    "gerador de energia"
  ],
  "countries": [
    "BR"
  ],
  "languages": [
    "pt-BR"
  ],
  "status": "ALL",
  "type": "ALL",
  "sort": "relevance",
  "maxResultsPerQuery": 50
}' |
apify call brasildados/google-marcas-patentes-scraper-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/google-marcas-patentes-scraper-api"
        }
    }
}

```

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/s5A7zmi8w15fgBc76/builds/mkIcAahS1kfEZ4nsL/openapi.json