# Resumen de posicionamiento del dominio

**API:** Data API

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

**Tags:** DataForSEO

La presencia de búsqueda de un dominio: recuentos de palabras clave orgánicas y de pago, tráfico estimado y valor del tráfico, por `location_code`. Devuelve `se_type`, `target`, `total_count`, `items_count` e `items`. Envuelto en el sobre de DataForSEO: los datos en `tasks[0].result`, el resultado en `tasks[0].status_code`; una solicitud rechazada sigue devolviendo HTTP 200. Para las mismas cifras a lo largo del tiempo, usa `post_dataforseo_labs_google_historical_rank_live`; para muchos dominios a la vez, `post_dataforseo_labs_google_bulk_traffic_estimation_live`.

### Referencia de precios

- Medición: Coste de la respuesta notificado.
- Estimación de referencia por solicitud: USD 0.0121.
- Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Related links

- [este artículo del centro de ayuda](<https://dataforseo.com/help-center/how-is-etv-calculated>)
- [este artículo del centro de ayuda](<https://dataforseo.com/help-center/how-is-traffic-cost-calculated>)
- [este artículo del centro de ayuda](<https://dataforseo.com/help-center/whats-clickstream-estimated-traffic-volume-and-how-is-it-calculated>)
- [este artículo del centro de ayuda](<https://dataforseo.com/help-center/what-are-clickstream-based-metrics-and-how-do-we-calculate-them>)

## 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": {
          "target": {
            "type": "string",
            "description": "<em>dominio</em><br><strong>campo obligatorio</strong><br>el nombre de dominio del sitio web de destino<br>el dominio debe especificarse sin <code>https://</code> ni <code>www.</code>"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nombre completo de la ubicación</em><br>campo opcional<br>si usas este campo, no necesitas especificar <code>location_code</code><br>puedes obtener la lista de ubicaciones disponibles con su <code>location_name</code> haciendo una solicitud independiente a la <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignora este campo para obtener los resultados en todas las ubicaciones disponibles<br>ejemplo:<br><code class=\"long-string\">United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>código de ubicación</em><br>campo opcional<br>si usas este campo, no necesitas especificar <code>location_name</code><br>puedes obtener la lista de ubicaciones disponibles con su <code>location_code</code> haciendo una solicitud independiente a la <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignora este campo para obtener los resultados en todas las ubicaciones disponibles<br>ejemplo:<br><code class=\"long-string\">2840</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>nombre completo del idioma</em><br>campo opcional<br>si usas este campo, no necesitas especificar <code>language_code</code><br>puedes obtener la lista de idiomas disponibles con su <code>language_name</code> haciendo una solicitud independiente a la <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignora este campo para obtener los resultados en todos los idiomas disponibles<br>ejemplo:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>código de idioma</em><br>campo opcional<br>si usas este campo, no necesitas especificar <code>language_name</code><br>puedes obtener la lista de idiomas disponibles con su <code>language_code</code> haciendo una solicitud independiente a la <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>ignora este campo para obtener los resultados en todos los idiomas disponibles<br>ejemplo:<br><code class=\"long-string\">en</code>"
          },
          "ignore_synonyms": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>ignorar palabras clave muy similares</em><br>campo opcional<br>si se define como <code class=\"prettyprint\">true</code>, todas las palabras clave muy similares se excluirán de los cálculos de posicionamiento y tráfico, y los resultados se basarán en los datos de las palabras clave principales de los grupos de sinónimos<br>valor predeterminado: <code>false</code>"
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>el número máximo de resultados devueltos por dominio</em><br>campo opcional<br>valor predeterminado: <code>100</code><br>valor máximo: <code>1000</code>"
          },
          "offset": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>desplazamiento en el array de resultados de los elementos devueltos</em><br>campo opcional<br>valor predeterminado: <code>0</code><br>si especificas el valor <code>10</code>, se omitirán los diez primeros <code>items</code> del array de resultados y los datos se proporcionarán para los elementos siguientes"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificador de tarea definido por el usuario</em><br>campo opcional<br><em>el límite de caracteres es 255</em><br>puedes usar este parámetro para identificar la tarea y relacionarla con el resultado<br>encontrarás el valor de <code>tag</code> especificado en el objeto <code>data</code> de la respuesta"
          }
        },
        "example": [
          {
            "target": "dataforseo.com",
            "language_name": "English",
            "location_code": 2840
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "language_name": "English",
      "location_code": 2840
    }
  ]
}
```

## Responses

### 200 — Operación correcta

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object | null

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

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud POST"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tipo de motor de búsqueda</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de ubicación en un array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de idioma en un array POST</em>"
    },
    "metrics": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo"
      },
      "description": "<em>datos de ranking relevantes para el dominio especificado</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo`

```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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo`

```json
{
  "type": "object",
  "properties": {
    "se_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>tipo de motor de búsqueda</em>"
    },
    "target": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>dominio de destino en un array POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de ubicación en un array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de idioma en un array POST</em>"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>cantidad total de resultados de nuestra base de datos relevantes para tu solicitud</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el número de resultados devueltos en el array <code>items</code></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveItem"
          }
        ]
      },
      "description": "<em>contiene datos de ranking y tráfico</em>"
    }
  }
}
```

### Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo`

```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_DataforseoLabsGoogleDomainRankOverviewLiveResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_DataforseoLabsMetricsInfo

`#/components/schemas/Response36Afe1097B20_DataforseoLabsMetricsInfo`

```json
{
  "type": "object",
  "properties": {
    "pos_1": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #1</em>"
    },
    "pos_2_3": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #2-3</em>"
    },
    "pos_4_10": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #4-10</em>"
    },
    "pos_11_20": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #11-20</em>"
    },
    "pos_21_30": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #21-30</em>"
    },
    "pos_31_40": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #31-40</em>"
    },
    "pos_41_50": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #41-50</em>"
    },
    "pos_51_60": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #51-60</em>"
    },
    "pos_61_70": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #61-70</em>"
    },
    "pos_71_80": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #71-80</em>"
    },
    "pos_81_90": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #81-90</em>"
    },
    "pos_91_100": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #91-100</em>"
    },
    "etv": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>volumen de tráfico estimado</em><br>tráfico orgánico mensual estimado al dominio o subdominio<br>se calcula como el producto de los valores de CTR (click-through-rate) y de volumen de búsqueda de todas las palabras clave de la categoría para las que posiciona el dominio o subdominio<br>obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda"
    },
    "count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>recuento total de SERP orgánicas que contienen el dominio o subdominio</em>",
      "format": "int64"
    },
    "estimated_paid_traffic_cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>costo estimado de convertir el tráfico de búsqueda orgánica en pago</em><br>representa el costo mensual estimado (USD) de publicar anuncios para todas las palabras clave de la categoría para las que posiciona el dominio o subdominio<br>la métrica se calcula como el producto de los valores de <code>etv</code> orgánico y <code>cpc</code> de pago e indica el costo de dirigir el volumen estimado de tráfico orgánico mensual mediante publicidad PPC en Google Search<br>obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda"
    },
    "is_new": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de nuevos elementos posicionados</em><br>indica cuántos nuevos elementos posicionados se encontraron para el objetivo indicado"
    },
    "is_up": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el ranking subió</em><br>indica cuántos elementos posicionados del objetivo indicado subieron"
    },
    "is_down": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el ranking bajó</em><br>indica cuántos elementos posicionados del objetivo indicado bajaron"
    },
    "is_lost": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>elementos posicionados perdidos</em><br>indica cuántos elementos posicionados del objetivo indicado se presentaban anteriormente en las SERP, pero no se encontraron durante la última comprobación"
    },
    "clickstream_etv": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>volumen de tráfico estimado basado en datos de clickstream</em><br>se calcula como el producto de los valores de click-through-rate y de volumen de búsqueda de clickstream de todas las palabras clave para las que posiciona el dominio<br>para obtener resultados de este campo, el parámetro <code>include_clickstream_data</code> debe establecerse en <code>true</code><br>obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda",
      "format": "double"
    },
    "clickstream_gender_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>distribución de métricas estimadas basadas en clickstream por género</em><br>para obtener resultados de este campo, el parámetro <code>include_clickstream_data</code> debe establecerse en <code>true</code><br>obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda"
    },
    "clickstream_age_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "int64"
      },
      "description": "<em>distribución de métricas basadas en clickstream por edad</em><br>para obtener resultados de este campo, el parámetro <code>include_clickstream_data</code> debe establecerse en <code>true</code><br>obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda"
    }
  }
}
```
