# Estimativa de tráfego em lote

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live`

**Tags:** DataForSEO

Tráfego orgânico estimado para muitos domínios em uma chamada. Este endpoint não aceita parâmetro de limite, mas é cobrado por chamada e não por item, então envie a lista inteira de uma vez. Encapsulado no envelope do DataForSEO: dados em `tasks[0].result`, resultado em `tasks[0].status_code` — uma requisição rejeitada ainda retorna HTTP 200. O preço é por chamada, então é assim que se classifica uma lista de concorrentes a baixo custo antes de gastar chamadas por domínio nos mais interessantes. A versão histórica é `post_dataforseo_labs_google_historical_bulk_traffic_live`.

### Referência de preços

- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.1356.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

## Related links

- [neste artigo da central de ajuda](<https://dataforseo.com/help-center/how-is-etv-calculated>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "targets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>domínios, subdomínios e páginas web de destino</em><br><strong>campo obrigatório</strong><br>você pode especificar domínios, subdomínios e páginas web neste campo;<br>domínios e subdomínios devem ser especificados sem <code>https://</code> e <code>www.</code>;<br>páginas devem ser especificadas com URL absoluta, incluindo <code>https://</code> e <code>www.</code>;<br>você pode definir até 1000 domínios, subdomínios ou páginas web"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nome completo do local</em><br>se você usar este campo, não precisa especificar <code>location_code</code><br>você pode obter a lista de locais disponíveis com seu <code>location_name</code> fazendo uma requisição separada para a <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignore este campo para obter os resultados de todos os locais disponíveis<br>exemplo:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>código do local</em><br>se você usar este campo, não precisa especificar <code>location_name</code><br>você pode obter a lista de locais disponíveis com seu <code>location_code</code> fazendo uma requisição separada para a <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignore este campo para obter os resultados de todos os locais disponíveis<br>exemplo:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nome completo do idioma</em><br>se você usar este campo, não precisa especificar <code>language_code</code><br>você pode obter a lista de idiomas disponíveis com seus <code>language_name</code> fazendo uma requisição separada para a <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignore este campo para obter os resultados de todos os idiomas disponíveis<br>exemplo:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>código do idioma</em><br>se você usar este campo, não precisa especificar <code>language_name</code><br>você pode obter a lista de idiomas disponíveis com seus <code>language_code</code> fazendo uma requisição separada para a <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignore este campo para obter os resultados de todos os idiomas disponíveis<br>exemplo:<br><code class=\"long-string\">en</code>"
          },
          "item_types": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>exibe resultados por tipo de item</em><br>campo opcional<br>indica o tipo de resultados de pesquisa incluídos na resposta<p><strong>Observação:</strong> se o array <code>item_types</code> contiver tipos de item diferentes de <code>organic</code>, os resultados serão ordenados pelo primeiro tipo de item do array<p>valores possíveis: <br><code>[\"organic\", \"paid\", \"featured_snippet\", \"local_pack\"]</code><br>valor padrão: <br><code>[\"organic\", \"paid\"]</code>"
          },
          "ignore_synonyms": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>ignora palavras-chave altamente semelhantes</em><br>campo opcional<br>se definido como <code class=\"prettyprint\">true</code>, apenas palavras-chave principais serão retornadas e todas as palavras-chave altamente semelhantes serão excluídas;  <br>valor padrão: <code>false</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificador de tarefa definido pelo usuário</em><br>campo opcional<br><em>o limite de caracteres é 255</em><br>você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado<br>você encontrará o valor de <code>tag</code> especificado no objeto <code>data</code> da resposta"
          }
        },
        "example": [
          {
            "targets": [
              "dataforseo.com",
              "cnn.com",
              "forbes.com"
            ],
            "location_code": 2840,
            "language_code": "en",
            "item_types": [
              "organic",
              "paid"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "targets": [
        "dataforseo.com",
        "cnn.com",
        "forbes.com"
      ],
      "location_code": 2840,
      "language_code": "en",
      "item_types": [
        "organic",
        "paid"
      ]
    }
  ]
}
```

## Responses

### 200 — Operação bem-sucedida

Headers:
- `X-Request-Id` (string) — Identificador da requisição a incluir ao contatar o suporte da Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResponseInfo"
    }
  ]
}
```

### 400 — Não foi possível processar a requisição. Verifique os parâmetros da requisição.

### 401 — É necessária uma chave de API da Felo válida.

### 402 — A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

### 403 — A conta não tem permissão para realizar esta operação.

### 429 — Um limite de requisições ou de gastos foi atingido.

### 502 — O serviço não pôde concluir a requisição.

### 503 — A API ou o serviço de cobrança está temporariamente indisponível.

### 504 — O serviço atingiu o tempo limite ao processar a requisição.

### default — Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "a versão atual da API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de status geral\nvocê pode encontrar a lista completa dos códigos de resposta aqui"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensagem informativa geral\nvocê pode encontrar a lista completa das mensagens informativas gerais aqui"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tempo total de execução, em segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "custo total das tarefas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "o número de tarefas no array de tarefas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "o número de tarefas no array de tarefas retornadas com erro",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador da tarefa\nidentificador exclusivo da tarefa em nosso sistema no formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de status da tarefa\ngerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000\nvocê pode encontrar a lista completa dos códigos de resposta aqui"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensagem informativa da tarefa\nvocê pode encontrar a lista completa das mensagens informativas gerais aqui"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tempo de execução, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "custo total das tarefas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos no array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "caminho da URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contém os mesmos parâmetros que você especificou na requisição POST"
    }
  }
}
```

### Response36Afe1097B20_BulkMetricsBundleInfo

`#/components/schemas/Response36Afe1097B20_BulkMetricsBundleInfo`

```json
{
  "type": "object",
  "properties": {
    "organic": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BulkMetricsInfo"
        }
      ],
      "description": "<em>dados de tráfego da pesquisa orgânica</em>"
    },
    "paid": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BulkMetricsInfo"
        }
      ],
      "description": "<em>dados de tráfego da pesquisa paga</em>"
    },
    "local_pack": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BulkMetricsInfo"
        }
      ],
      "description": "<em>dados de tráfego dos resultados do pacote local na SERP</em>"
    },
    "featured_snippet": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BulkMetricsInfo"
        }
      ],
      "description": "<em>dados de tráfego dos resultados de snippet em destaque no SERP do Google</em>"
    }
  }
}
```

### Response36Afe1097B20_BulkMetricsInfo

`#/components/schemas/Response36Afe1097B20_BulkMetricsInfo`

```json
{
  "type": "object",
  "properties": {
    "etv": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>volume de tráfego estimado</em><br>tráfego orgânico mensal estimado para o domínio<br>calculado como o produto dos valores de CTR (taxa de cliques) e de volume de pesquisa de todas as palavras-chave para as quais o domínio se posiciona<br>saiba mais sobre como a métrica é calculada neste artigo da central de ajuda"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>contagem total de SERPs orgânicas que contêm o domínio</em>",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tipo de mecanismo de busca</em>"
    },
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>domínio de destino em um array POST</em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_BulkMetricsBundleInfo"
        }
      ],
      "description": "<em>dados de tráfego relevantes para o domínio especificado</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo"
              }
            ]
          },
          "description": "<em>array de tarefas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tipo de mecanismo de busca</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de localização em um array do POST</em><br>se não houver dados, o valor é <code>null</code>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código do idioma em um array do POST</em><br>se não houver dados, o valor é <code>null</code>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>quantidade total de resultados em nosso banco de dados relevantes para a sua solicitação</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>o número de resultados retornados no array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveItem"
          }
        ]
      },
      "description": "<em>array de itens com dados relevantes de estimativa de tráfego</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```
