# Impostare le attività Apple App Reviews

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/app_data/apple/app_reviews/task_post`

**Tags:** DataForSEO

Accoda le recensioni di un'app dell'App Store tramite `app_id` e restituisce un `id` attività. `depth` stabilisce quante raccoglierne. Asincrono: submit restituisce un `id` attività in `tasks[0].id` e lo strumento fetch restituisce il risultato quando è pronto. Recuperare con `get_dataforseo_app_apple_app_reviews_fetch`.

### Riferimento prezzi

- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.012.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

## Related links

- [Pricing](<https://dataforseo.com/pricing/api/app-store>)
- [Pricing](<https://dataforseo.com/pricing/app-data/app-store>)
- [Help Center](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## 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": {
          "app_id": {
            "type": "string",
            "description": "<em>id dell'app</em><br><strong>campo obbligatorio</strong><br>ID dell'applicazione mobile su App Store;<br>l'ID è reperibile nell'URL di ogni app elencata su App Store;<br>esempio:<br>nell'URL <code>https://apps.apple.com/us/app/id<strong>835599320</strong></code><br>l'id è <code>835599320</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>nome completo della posizione del motore di ricerca</em><br><strong>campo obbligatorio se non si specifica <code>location_code</code></strong><br><strong>se si usa questo campo, non è necessario specificare <code>location_code</code></strong><br>è possibile ricevere l'elenco delle posizioni disponibili del motore di ricerca con il relativo <code>location_name</code> effettuando una richiesta separata a <code>https://api.dataforseo.com/v3/app_data/apple/locations</code><br>esempio:<br><code class=\"long-string\">West Los Angeles,California,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>codice posizione del motore di ricerca</em><br><strong>campo obbligatorio se non si specifica <code>location_name</code></strong><br><strong>se si usa questo campo, non è necessario specificare <code>location_name</code></strong><br>è possibile ricevere l'elenco delle posizioni disponibili del motore di ricerca con il relativo <code>location_code</code> effettuando una richiesta separata a <code>https://api.dataforseo.com/v3/app_data/apple/locations</code><br>esempio:<br><code class=\"long-string\">9061121</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>nome completo della lingua del motore di ricerca</em><br><strong>campo obbligatorio se non si specifica <code>language_code</code></strong><br>se si usa questo campo, non è necessario specificare <code>language_code</code><br>è possibile ricevere l'elenco delle lingue disponibili con <code>language_name</code> effettuando una richiesta separata a <code>https://api.dataforseo.com/v3/app_data/apple/languages</code><br>esempio:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>codice lingua del motore di ricerca</em><br><strong>campo obbligatorio se non si specifica <code>language_name</code></strong><br>se si usa questo campo, non è necessario specificare <code>language_name</code><br>è possibile ricevere l'elenco delle lingue disponibili con il relativo <code>language_code</code>_ effettuando una richiesta separata a <code>https://api.dataforseo.com/v3/app_data/apple/languages</code><em><br></em>esempio:<em><br></em><code class=\"long-string\">en</code>n"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>priorità dell'attività</em><br>campo facoltativo<br>può assumere i seguenti valori:<br>1 – priorità di esecuzione normale (impostata per impostazione predefinita)<br>2 – priorità di esecuzione alta. Per le attività con priorità di esecuzione alta viene addebitato un costo aggiuntivo.<br>Il costo può essere calcolato nella pagina Pricing."
          },
          "depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>profondità di parsing</em><br>campo facoltativo<br>numero di recensioni da restituire nella risposta API;<br>si consiglia vivamente di impostare la profondità di parsing in multipli di 25, perché il nostro sistema elabora 25 recensioni di fila;<br>valore predefinito: <code>25</code>;<br>valore massimo: <code>500</code>;<p><strong>L'account viene fatturato per ogni SERP contenente fino a 25 risultati;</strong> <br>un'impostazione della profondità superiore a 25 può comportare costi aggiuntivi se il motore di ricerca restituisce più di 25 risultati</a>;<br>il costo può essere calcolato nella pagina Pricing."
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>parametri di ordinamento dei risultati</em><br>campo facoltativo<br>è possibile usare questo campo per ordinare i risultati;<br>tipi di ordinamento possibili:<br><code>most_recent</code> — ordina per le recensioni più recenti;<br><code>most_helpful</code> — ordina per le recensioni più pertinenti;<br>regola predefinita: <code>most_helpful</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificatore dell'attività definito dall'utente</em><br>campo facoltativo<br><em>il limite di caratteri è 255</em><br>puoi usare questo parametro per identificare l'attività e associarla al risultato<br>il valore <code>tag</code> specificato si trova nell'oggetto <code>data</code> della risposta"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL per l'invio dei risultati dell'attività</em><br>campo facoltativo<br>una volta completata l'attività, si invia una richiesta POST con i risultati compressi nel formato <code>gzip</code> all'indirizzo <code>postback_url</code> specificato<br>è possibile usare la stringa ‘$id’ come variabile <code>$id</code> e ‘$tag’ come variabile <code>$tag</code> codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.<br>esempio:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Nota:</strong> i caratteri speciali in <code>postback_url</code> verranno codificati per URL; <br>ad es. il carattere <code>#</code> verrà codificato in <code>%23</code><p>scopri di più nel nostro Help Center"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>tipo di dati postback_url</em><br><strong>campo obbligatorio se si specifica <code>postback_url</code></strong><br>corrisponde al tipo di dati che verrà inviato al server<br>valori possibili:<br><code>advanced</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL di notifica di un'attività completata</em><br>campo facoltativo<br>al completamento di un'attività si riceverà una notifica tramite una richiesta GET all'URL specificato<br>è possibile usare la stringa ‘$id’ come variabile <code>$id</code> e ‘$tag’ come variabile <code>$tag</code> codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.<br>esempio:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Nota:</strong> i caratteri speciali in <code>pingback_url</code> verranno codificati per URL; <br>ad es. il carattere <code>#</code> verrà codificato in <code>%23</code><p>scopri di più nel nostro Help Center"
          }
        },
        "example": [
          {
            "app_id": "835599320",
            "location_code": 2840,
            "language_code": "en",
            "depth": 200
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_id": "835599320",
      "location_code": 2840,
      "language_code": "en",
      "depth": 200
    }
  ]
}
```

## Responses

### 200 — Operazione riuscita

Headers:
- `X-Request-Id` (string) — Identificatore della richiesta da includere quando contatti l'assistenza Felo.

**application/json**

Schema: object | null

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

### 400 — Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

### 401 — È richiesta una chiave API Felo valida.

### 402 — Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

### 403 — L'account non è autorizzato a eseguire questa operazione.

### 429 — È stato raggiunto un limite di richieste o di spesa.

### 502 — Il servizio non è riuscito a completare la richiesta.

### 503 — L'API o il servizio di fatturazione è temporaneamente non disponibile.

### 504 — Si è verificato un timeout durante l'elaborazione della richiesta.

### default — Risposta di errore; le risposte passthrough upstream possono usare formati del provider

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppDataAppleAppReviewsTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AppDataAppleAppReviewsTaskPostResponseInfo`

```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_AppDataAppleAppReviewsTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>array di attività</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AppDataAppleAppReviewsTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataAppleAppReviewsTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>array di risultati</em><br>in questo caso il valore sarà <code>null</code>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "La versione corrente dell'API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "codice di stato generale\nl'elenco completo dei codici di risposta è disponibile qui"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "messaggio informativo generale\nl'elenco completo dei messaggi informativi generali è disponibile qui"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tempo di esecuzione totale, secondi"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "Costo totale delle attività, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Il numero di attività nell'array tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Il numero di attività nell'array tasks restituite con un errore",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificatore dell'attività\nidentificatore univoco dell'attività nel nostro sistema in formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "codice di stato dell'attività\ngenerato da DataForSEO, può essere compreso nell'intervallo: 10000-60000\nl'elenco completo dei codici di risposta è disponibile qui"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "messaggio informativo dell'attività\nl'elenco completo dei messaggi informativi generali è disponibile qui"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "Tempo di esecuzione in secondi"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "Costo totale delle attività, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Numero di elementi nell'array dei risultati",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "Percorso URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "Contiene gli stessi parametri specificati nella richiesta POST"
    }
  }
}
```
