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

Tarefas de redes sociais do Pinterest em tempo real

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

DataForSEO

​

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

Tarefas de redes sociais do Pinterest em tempo real

​

Quantas vezes cada um dos targets foi fixado no Pinterest. Retorna type, page_url e pins_count por URL. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Aceita uma lista, então verifique as páginas de um site inteiro em uma chamada. Para conteúdo do Pinterest em vez de contagens, o servidor Pinterest lê a plataforma diretamente.

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
obrigatório
application/json
  • Tipo: array object[]
    • targets
      Tipo: array string[]
      obrigatório

      URLs de destino campo obrigatório a página de destino deve ser especificada com sua URL absoluta (incluindo http:// ou https://) exemplo: https://dataforseo.com/Observação: você pode especificar no máximo 10 destinos. Você será cobrado por cada URL especificada neste array

    • tag
      Tipo: string

      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

    Resposta bem-sucedida

    • result
      Tipo: array string[]

      array de resultados

    • result.page_url
      Tipo: string

      URL da página para a qual os dados são fornecidos a URL correspondente que você especificou no array targets ao definir uma tarefa

    • result.pins_count
      Tipo: integer

      número de pins para o page_url relacionado os pins no Pinterest correspondem a salvamentos de conteúdo; este campo mostra o número de salvamentos de conteúdo feitos a partir do page_url relacionado usando o Pinterest Save Button

    • result.type
      Tipo: string

      tipo de elemento = ‘social_media_pinterest_item’

    • tasks
      Tipo: array string[]

      array de tarefas

    • tasks.cost
      Tipo: number

      custo da tarefa, USD

    • tasks.data
      Tipo: object

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

    • tasks.id
      Tipo: string

      identificador exclusivo da tarefa em nosso sistema no formato Identificador único universal (UUID)

    • tasks.path
      Tipo: array string[]

      caminho da URL

    • tasks.result_count
      Tipo: integer

      número de elementos no array result

    • tasks.status_code
      Tipo: integer

      código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000

    • tasks.status_message
      Tipo: string

      mensagem informativa da tarefa

    • tasks.time
      Tipo: string

      tempo de execução, segundos

    • version
      Tipo: string

      a versão atual da API

    • version.cost
      Tipo: number

      custo total das tarefas, USD

    • version.status_code
      Tipo: integer

      código de status geral você pode encontrar a lista completa dos códigos de resposta aqui Observação: recomendamos fortemente projetar um sistema necessário para tratar condições excepcionais ou de erro relacionadas

    • version.status_message
      Tipo: string

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

    • version.tasks_count
      Tipo: integer

      *o número de tarefas no **tasks*array

    • version.tasks_error
      Tipo: integer

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

    • version.time
      Tipo: string

      tempo de execução, segundos

    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/social_media/pinterest/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/social_media/pinterest/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      ""
    ],
    "tag": ""
  }
]'
{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.type": "string",
  "result.page_url": "string",
  "result.pins_count": 1
}
Live Social Media Pinterest Tasks