v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – API de pesquisa

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

post/v1/beta/dataforseo/content_analysis/search/live

Content Analysis – API de pesquisa

Lista as páginas individuais que citam uma palavra-chave, em vez dos totais. Cada item traz url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score e page_category, além de total_count e items_count. filters aceita os campos listados por get_dataforseo_content_available_filters. Para contagens e distribuições em vez de páginas, use post_dataforseo_content_summary_live.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.0276.
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)[]
- filters
  Tipo: array (object | null)[] | null
  
  array de parâmetros de filtragem de resultados
  campo opcional
  você pode adicionar vários filtros de uma vez (máximo de 8 filtros)
  você deve definir um operador lógico and, or entre as condições
  os seguintes operadores são suportados:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  exemplo:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  para mais informações sobre filtros, consulte Content Analysis API - Filters
  
  Objeto vazio
- keyword
  Tipo: string
  
  palavra-chave de destino
  campo obrigatório
  codificação UTF-8
  as palavras-chave serão convertidas para o formato minúsculo;
  Observação: para corresponder a uma frase exata em vez de uma palavra-chave isolada, use aspas duplas e barras invertidas;
  exemplo:
  "keyword": "\"tesla palo alto\""
  
  saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda
- keyword_fields
  Tipo: object | null
  
  campos de palavra-chave de destino e palavras-chave de destino
  campo opcional
  use este parâmetro para filtrar o conjunto de dados por palavras-chave que determinados campos devem conter;
  campos que você pode especificar: title, main_title, previous_title, snippet
  você pode indicar vários campos;
  Observação: para corresponder a uma frase exata em vez de uma palavra-chave isolada, use aspas duplas e barras invertidas;
  exemplo:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  Tipo: string | null
- limit
  Tipo: integer | null
  
  o número máximo de citações retornadas
  campo opcional
  valor padrão: 100
  valor máximo: 1000
- offset
  Tipo: integer | null
  
  deslocamento no array de resultados das citações retornadas
  campo opcional
  valor padrão: 0
  se você especificar o valor 10, as dez primeiras citações do array de resultados serão omitidas e os dados serão fornecidos para as citações seguintes
  Observação: recomendamos usar este parâmetro apenas ao recuperar até 10.000 resultados
  para recuperar mais de 10.000 resultados, use o offset_token.
- offset_token
  Tipo: string | null
  
  token de deslocamento para requisições subsequentes
  campo opcional
  fornecido no campo idêntico da resposta a cada requisição;
  use este parâmetro para evitar timeouts ao tentar obter mais de 10.000 resultados em uma única requisição;
  ao especificar o valor exclusivo de offset_token do array de resposta, você obterá os resultados subsequentes da tarefa inicial;
  os valores de offset_token são exclusivos para cada tarefa subsequente
  Observação: se o offset_token for especificado na requisição, todos os outros parâmetros, exceto limit, não serão considerados ao processar a tarefa
  saiba mais sobre este parâmetro na nossa Central de Ajuda
- order_by
  Tipo: array string[] | null
  
  regras de ordenação dos resultados
  campo opcional
  você pode usar os mesmos valores do array filters para ordenar os resultados
  tipos de ordenação possíveis:
  asc - os resultados serão ordenados em ordem crescente
  desc - os resultados serão ordenados em ordem decrescente
  você deve usar uma vírgula para definir um tipo de ordenação
  exemplo:
  ["content_info.sentiment_connotations.anger,desc"]
  regra padrão:
  ["content_info.sentiment_connotations.anger,desc"]
  observe que você pode definir no máximo três regras de ordenação em uma única requisição
  você deve usar uma vírgula para separar várias regras de ordenação
  exemplo:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  Tipo: array string[] | null
  
  tipos de página de destino
  campo opcional
  use este parâmetro para filtrar o conjunto de dados por tipos de página
  valores possíveis:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  Tipo: string | null
  
  define a escala usada para calcular e exibir os valores de domain_rank e url_rank
  campo opcional
  
  você pode usar este parâmetro para escolher se os valores de rank são apresentados em uma escala de 0–100 ou de 0–1000
  
  valores possíveis:
  one_hundred — os valores de rank são exibidos em uma escala de 0–100
  one_thousand — os valores de rank são exibidos em uma escala de 0–1000
  
  valor padrão: one_thousand
  
  saiba mais sobre como este parâmetro funciona neste artigo da Central de Ajuda
- search_mode
  Tipo: string | null
  
  tipo de agrupamento dos resultados
  campo opcional
  tipos de agrupamento possíveis:
  as_is - retorna todas as citações para a keyword de destino
  one_per_domain - retorna uma citação da keyword por domínio
  valor padrão: as_is
- 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_ContentAnalysisSearchLiveResponseInfo
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_ContentAnalysisSearchLiveTaskInfo
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

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

contém citações e dados relacionados

content_info
Tipo: object | null · Response36Afe1097B20_AnalysisContentInfo

contém dados sobre citações do url fornecido

author
Tipo: string | null

autor do conteúdo

connotation_types
Tipo: object | null

tipos de conotação
contém os tipos de sentimentos (polaridade do sentimento) relacionados à citação em questão e o índice de probabilidade de cada tipo de sentimento
tipos de conotação de sentimento possíveis: positive, negative, neutral

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

content_quality_score
Tipo: integer | null

pontuação de qualidade do conteúdo
este valor é calculado com base no número de palavras, frases e caracteres que o conteúdo contém

content_type
Tipo: string | null

tipo de conteúdo
exemplo:
page_content, comment

date_published
Tipo: string | null

data e hora em que o conteúdo foi publicado
no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
exemplo:
2017-01-24 13:20:59 +00:00

group_date
Tipo: string | null

data e hora do grupo de citações
indica a data de publicação do conteúdo ou a data e hora em que nosso crawler visitou a página pela primeira vez;
este campo pode ser usado para agrupar citações por data e exibir tendências de citação;
a data e hora são fornecidas no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
exemplo:
2017-01-24 13:20:59 +00:00

highlighted_text
Tipo: string | null

texto destacado do snippet

language
Tipo: string | null

idioma principal do domínio
para obter uma lista completa dos idiomas disponíveis, consulte o endpoint Languages

level
Tipo: integer | null

nível de título title
indica o nível da tag h de 1 (superior) a 6 (inferior)

main_title
Tipo: string | null

título da página

previous_title
Tipo: string | null

título do bloco de conteúdo anterior

rating
Tipo: object | null · Response36Afe1097B20_ContententRatingInfo

classificação de conteúdo
classificação relacionada a content_info

max_rating_value
Tipo: number | null Formato: double

valor máximo para o nome da avaliação

name
Tipo: string | null

nome da avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

rating_count
Tipo: integer | null Formato: int64

número de votos

rating_value
Tipo: number | null Formato: double

o valor da avaliação

relative_rating
Tipo: number | null Formato: double

avaliação relativa

semantic_location
Tipo: string | null

local semântico
indica o elemento semântico no HTML onde a citação da palavra-chave de destino está localizada
exemplo:
article, header

sentiment_connotations
Tipo: object | null

conotações de sentimento
contém os sentimentos (reações emocionais) relacionados à citação em questão e o índice de probabilidade de cada sentimento
conotações de sentimento possíveis: anger, happiness, love, sadness, share, fun

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

snippet
Tipo: string | null

snippet do conteúdo

snippet_length
Tipo: integer | null

comprimento em caracteres do snippet

social_metrics
Tipo: array (object | null)[] | null

métricas de engajamento em redes sociais
dados sobre interações em redes sociais associadas ao conteúdo, com base em incorporações de sites desenvolvidas e suportadas por plataformas de redes sociais

like_count
Tipo: integer | null Formato: int64

contagem de curtidas

type
Tipo: string | null

tipo de elemento

text_category
Tipo: array integer[] | null

categoria do texto
para obter uma lista completa de categorias disponíveis, consulte o endpoint Categories

title
Tipo: string | null

título do resultado

country
Tipo: string | null

código do país de registro do domínio
para obter uma lista completa dos países disponíveis, consulte o endpoint Locations

domain
Tipo: string | null

nome do domínio

domain_rank
Tipo: integer | null

ranking do domain
este valor é baseado em dados de backlinks do domínio fornecido do DataForSEO Backlink Index;
domain_rank é calculado com base no método de classificação de nós em um banco de dados vinculado — um princípio usado no algoritmo PageRank original do Google
saiba mais sobre a métrica e como ela é calculada neste artigo da central de ajuda

fetch_time
Tipo: string | null

data e hora em que nosso rastreador visitou a página
no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
exemplo:
2017-01-24 13:20:59 +00:00

language
Tipo: string | null

idioma principal do domínio
para obter uma lista completa dos idiomas disponíveis, consulte o endpoint Languages

main_domain
Tipo: string | null

domínio principal

page_category
Tipo: array integer[] | null

contém todas as categorias de página relevantes
categorias de produtos e serviços relevantes para a página
para obter uma lista completa das categorias disponíveis, consulte o endpoint Categories

page_types
Tipo: array string[] | null

tipos de página

ratings
Tipo: array (object | null)[] | null

avaliações encontradas na página
todas as avaliações encontradas na página com base em microdados

max_rating_value
Tipo: number | null Formato: double

valor máximo para o nome da avaliação

name
Tipo: string | null

nome da avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

rating_count
Tipo: integer | null Formato: int64

número de votos

rating_value
Tipo: number | null Formato: double

o valor da avaliação

relative_rating
Tipo: number | null Formato: double

avaliação relativa

score
Tipo: number | null

pontuação de proeminência da citação
este valor é baseado na presença de url_rank, domain_rank, keyword em title, main_title, url, snippet
quanto maior o score, mais valiosa é a citação relacionada

social_metrics
Tipo: array (object | null)[] | null

métricas de engajamento em redes sociais
dados sobre interações em redes sociais associadas ao conteúdo, com base em incorporações de sites desenvolvidas e suportadas por plataformas de redes sociais

like_count
Tipo: integer | null Formato: int64

contagem de curtidas

type
Tipo: string | null

tipo de elemento

spam_score
Tipo: integer | null

pontuação de spam de backlinks da url
este valor é baseado em dados de backlinks da URL fornecida do DataForSEO Backlink Index;
saiba mais sobre como a métrica é calculada nesta página da central de ajuda

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

URL onde a citação foi encontrada

url_rank
Tipo: integer | null

ranking da url
este valor é baseado em dados de backlinks da URL fornecida do DataForSEO Backlink Index;
url_rank é calculado com base no método de classificação de nós em um banco de dados vinculado — um princípio usado no algoritmo PageRank original do Google
saiba mais sobre a métrica e como ela é calculada neste artigo da central de ajuda

items_count
Tipo: integer | null Formato: int64

o número de resultados retornados no array items

offset_token
Tipo: string | null

token de deslocamento para requisições subsequentes
você pode usar a string fornecida neste campo para obter os resultados subsequentes da tarefa inicial;
observação: os valores de offset_token são exclusivos para cada tarefa subsequente

total_count
Tipo: integer | null Formato: int64

quantidade total de resultados em nosso banco de dados relevantes para a sua solicitação

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

post/v1/beta/dataforseo/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

Mostrar Schema

{
  "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Content Analysis – API de pesquisa

AutenticaçãoRequired

DataForSEO

Content Analysis – API de pesquisa

Referência de preços