Felo API PlatformFelo API Platform
Todos os endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Configurar tarefas de perguntas e respostas do Google My Business em tempo real

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas Cliente
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operações

Configurar tarefas de perguntas e respostas do Google My Business em tempo real

​

As perguntas e respostas de um Google Business Profile, encontradas por keyword e location_code. Retorna keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id e item_types. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200.

Referência de preços

  • Medição: Custo da resposta reportado.
  • Estimativa de referência por requisição: USD 0.2428.
  • 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.

Corpo
application/json
  • Tipo: array (object | null)[]
    • depth
      Tipo: integer | null

      profundidade de análise
      campo opcional
      número de resultados na SERP
      valor padrão: 20
      valor máximo: 100
      Sua conta será cobrada por cada SERP contendo até 20 resultados;
      Definir uma profundidade acima de 20 pode gerar cobranças adicionais se o mecanismo de busca retornar mais de 20 resultados;
      Se a profundidade especificada for maior que o número de perguntas na resposta, a diferença será reembolsada automaticamente no saldo da sua conta;
      O custo pode ser calculado na página Preços.

    • keyword
      Tipo: string

      palavra-chave
      campo obrigatório
      a palavra-chave especificada deve indicar o nome do estabelecimento local
      você pode especificar até 700 caracteres no campo keyword
      todos os %## serão decodificados (o caractere ‘+’ será decodificado como espaço)
      se precisar usar o caractere “%” no seu keyword, especifique-o como “%25”;

      este campo também pode ser usado para passar os seguintes parâmetros:
      cid - um id exclusivo da entidade comercial, definido pelo Google;
      place_id - um identificador da entidade comercial no Google Maps;

      exemplo:
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      saiba mais sobre os identificadores cid e place_id neste artigo da Central de Ajuda

      saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda

    • language_code
      Tipo: string

      código do idioma do mecanismo de busca
      campo obrigatório se você não especificar language_name
      se você usar este campo, não precisa especificar language_name
      você pode obter a lista de idiomas disponíveis com seu language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/languages
      exemplo:
      en

    • language_name
      Tipo: string

      nome completo do idioma do mecanismo de busca
      campo obrigatório se você não especificar language_code
      se você usar este campo, não precisa especificar language_code
      você pode obter a lista de idiomas disponíveis com language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/languages
      exemplo:
      English

    • location_code
      Tipo: integer

      código de localização do mecanismo de pesquisa
      campo obrigatório se você não especificar location_name ou location_coordinate
      se você usar este campo, não precisará especificar location_name ou location_coordinate
      você pode receber a lista de localizações disponíveis com location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/locations
      exemplo:
      2840

    • location_coordinate
      Tipo: string

      coordenadas GPS de um local
      campo obrigatório se você não especificar location_name_or location_code
      se você usar este campo, não precisa especificar location_name ou location_code
      o parâmetro location_coordinate deve ser especificado no formato "latitude,longitude,radius"
      o número máximo de casas decimais para "latitude" e "longitude": 7
      o valor mínimo para "radius": 199.9 (mm)
      o valor máximo para "radius": 199999 (mm)
      exemplo:
      53.476225,-2.243572,200

    • location_name
      Tipo: string

      nome completo do local do mecanismo de busca
      campo obrigatório se você não especificar location_code ou location_coordinate
      se você usar este campo, não precisa especificar location_code ou location_coordinate
      você pode obter a lista de locais disponíveis com location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/business_data/google/locations
      exemplo:
      London,England,United Kingdom

    • tag
      Tipo: string | null

      identificador de tarefa definido pelo usuário
      campo opcional
      o limite de caracteres é 255
      você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
      você encontrará o valor de tag especificado no objeto data da resposta

Respostas
  • 200
    Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • cost
      Tipo: number | null Formato: double

      custo total das tarefas, USD

    • status_code
      Tipo: integer | null

      código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

    • status_message
      Tipo: string | null

      mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

    • tasks
      Tipo: array (object | null)[] | null

      array de tarefas

      • Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • cost
          Tipo: number | null Formato: double

          custo total das tarefas, USD

        • data
          Tipo: object | null

          contém os mesmos parâmetros que você especificou na requisição POST

          • propertyName
            Tipo: object | null
        • id
          Tipo: string | null

          identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

        • path
          Tipo: array (string | null)[] | null

          caminho da URL

        • result
          Tipo: array (object | null)[] | null

          array de resultados

          • check_url
            Tipo: string | null

            URL direta para os resultados do mecanismo de busca
            você pode usá-la para garantir que fornecemos resultados precisos

          • cid
            Tipo: string | null

            ID de cliente definido pelo Google
            ID exclusivo de um estabelecimento local;
            saiba mais sobre o identificador neste artigo da central de ajuda

          • datetime
            Tipo: string | null

            data e hora em que o resultado foi recebido
            no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            exemplo:
            2019-11-15 12:57:46 +00:00

          • feature_id
            Tipo: string | null

            identificador exclusivo do recurso de SERP

          • item_types
            Tipo: array (string | null)[] | null

            tipos de itens
            tipos de resultados de pesquisa encontrados no array items;
            tipos de itens possíveis: google_business_question_item

          • items
            Tipo: array (object | null)[] | null

            array de itens
            itens dentro de google_business_question_item

            • items
              Tipo: array (object | null)[] | null

              array de itens
              itens dentro de google_business_question_item

              • answer_id
                Tipo: string | null

                ID da resposta

              • answer_text
                Tipo: string | null

                texto atual da resposta

              • original_answer_text
                Tipo: string | null

                texto original da resposta

              • profile_image_url
                Tipo: string | null

                URL da imagem de perfil do usuário

              • profile_name
                Tipo: string | null

                nome de exibição do usuário

              • profile_url
                Tipo: string | null

                URL do perfil do usuário

              • time_ago
                Tipo: string | null

                hora estimada em que a resposta foi publicada

              • timestamp
                Tipo: string | null

                hora exata em que a resposta foi publicada

              • type
                Tipo: string | null

                tipo de elemento

            • original_question_text
              Tipo: string | null

              texto original da pergunta

            • profile_image_url
              Tipo: string | null

              URL da imagem de perfil do usuário

            • profile_name
              Tipo: string | null

              nome de exibição do usuário

            • profile_url
              Tipo: string | null

              URL do perfil do usuário

            • question_id
              Tipo: string | null

              ID da pergunta

            • question_text
              Tipo: string | null

              texto atual da pergunta

            • rank_absolute
              Tipo: integer | null

              ranking absoluto entre todos os elementos

            • rank_group
              Tipo: integer | null

              posição dentro de um grupo de elementos com valores de type idênticos
              as posições dos elementos com valores de type diferentes são omitidas de rank_group

            • time_ago
              Tipo: string | null

              horário estimado em que a pergunta foi postada

            • timestamp
              Tipo: string | null

              horário exato em que a pergunta foi postada

            • type
              Tipo: string | null

              tipo de elemento

            • url
              Tipo: string | null

              URL da pergunta

          • items_count
            Tipo: integer | null Formato: int64

            o número de itens no array items

          • items_without_answers
            Tipo: array (object | null)[] | null

            array de itens de perguntas do Google Business sem respostas

            • items
              Tipo: array (object | null)[] | null

              array de itens
              itens dentro de google_business_question_item

              • answer_id
                Tipo: string | null

                ID da resposta

              • answer_text
                Tipo: string | null

                texto atual da resposta

              • original_answer_text
                Tipo: string | null

                texto original da resposta

              • profile_image_url
                Tipo: string | null

                URL da imagem de perfil do usuário

              • profile_name
                Tipo: string | null

                nome de exibição do usuário

              • profile_url
                Tipo: string | null

                URL do perfil do usuário

              • time_ago
                Tipo: string | null

                hora estimada em que a resposta foi publicada

              • timestamp
                Tipo: string | null

                hora exata em que a resposta foi publicada

              • type
                Tipo: string | null

                tipo de elemento

            • original_question_text
              Tipo: string | null

              texto original da pergunta

            • profile_image_url
              Tipo: string | null

              URL da imagem de perfil do usuário

            • profile_name
              Tipo: string | null

              nome de exibição do usuário

            • profile_url
              Tipo: string | null

              URL do perfil do usuário

            • question_id
              Tipo: string | null

              ID da pergunta

            • question_text
              Tipo: string | null

              texto atual da pergunta

            • rank_absolute
              Tipo: integer | null

              ranking absoluto entre todos os elementos

            • rank_group
              Tipo: integer | null

              posição dentro de um grupo de elementos com valores de type idênticos
              as posições dos elementos com valores de type diferentes são omitidas de rank_group

            • time_ago
              Tipo: string | null

              horário estimado em que a pergunta foi postada

            • timestamp
              Tipo: string | null

              horário exato em que a pergunta foi postada

            • type
              Tipo: string | null

              tipo de elemento

            • url
              Tipo: string | null

              URL da pergunta

          • keyword
            Tipo: string | null

            palavra-chave recebida em um array POST
            a palavra-chave é retornada com %## decodificado (o caractere '+' será decodificado como um espaço)
            este campo conterá o parâmetro cid se você o especificou no campo keyword ao definir uma tarefa;
            exemplo:
            cid:2946633002421908862
            saiba mais sobre o parâmetro neste artigo da central de ajuda

          • language_code
            Tipo: string | null

            código de idioma em um array POST

          • location_code
            Tipo: integer | null

            código de localização em um array POST

          • se_domain
            Tipo: string | null

            domínio do mecanismo de busca conforme especificado em um array POST

        • result_count
          Tipo: integer | null Formato: int64

          número de elementos no array de resultados

        • status_code
          Tipo: integer | null

          código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

        • status_message
          Tipo: string | null

          mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

        • time
          Tipo: string | null

          tempo de execução, segundos

    • tasks_count
      Tipo: integer | null Formato: int64

      o número de tarefas no array de tarefas

    • tasks_error
      Tipo: integer | null Formato: int64

      o número de tarefas no array de tarefas retornadas com erro

    • time
      Tipo: string | null

      tempo total de execução, em segundos

    • version
      Tipo: string | null

      a versão atual da API

    application/json
  • 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
Request Example for post/v1/beta/dataforseo/business_data/google/questions_and_answers/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Setting Live Google My Business Questions and Answers Tasks