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

Pesquisa de artigos de notícias

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

Apollo

​

Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.

Pesquisa de artigos de notícias

​

Cobertura de notícias sobre empresas específicas. organization_ids[] é obrigatório — omiti-lo retorna HTTP 422 com "organization_ids is required", então resolva as empresas primeiro com get_apollo_organizations_enrich. Refine com categories[] (financiamento, contratações, lançamentos e similares), published_at[min], published_at[max], e pagine com page e per_page. Retorna news_articles e pagination. Use para detectar um evento gatilho antes de entrar em contato. Requer permissão administrativa da Felo.

Pricing reference

  • Medição: unidades de recursos do plano.
  • Estimativa de referência por requisição: USD 0.01975.
  • Base de custo unitário: USD 0.0.
  • Unidade de recurso: provider_credit.
  • Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor já liquidado do cliente.
  • As bases de custo não definem o preço final do cliente, inclusive quando forem zero.

Apenas metadados de referência, não uma cotação da conta, um preço garantido nem 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.

Parâmetros de Consulta
  • categories[]
    Tipo: array string[]

    Filtre sua pesquisa para incluir apenas determinadas categorias ou subcategorias de notícias. Use o filtro News search para empresas do Apollo para descobrir todas as categorias e subcategorias possíveis. Exemplos: hires; investment; contract

  • organization_ids[]
    Tipo: array string[]
    obrigatório

    Os IDs do Apollo das empresas que você deseja incluir nos resultados da pesquisa. Cada empresa no banco de dados do Apollo recebe um ID exclusivo. Para encontrar IDs, chame o endpoint Organization Search e identifique os valores de organization_id. Exemplo: 5e66b6381e05b4008c8331b8

  • page
    Tipo: integer

    O número da página dos dados do Apollo que você deseja recuperar. Use este parâmetro em conjunto com o parâmetro per_page para tornar os resultados da pesquisa navegáveis e melhorar o desempenho do endpoint. Exemplo: 4

  • per_page
    Tipo: integer

    O número de resultados de pesquisa que deve ser retornado por página. Limitar o número de resultados por página melhora o desempenho do endpoint. Use o parâmetro page para pesquisar as diferentes páginas de dados. Exemplo: 10

  • published_at[max]
    Tipo: string

    Define o limite superior do intervalo de datas que você deseja pesquisar. Use este parâmetro em conjunto com o parâmetro published_at[min]. Esta data deve ser posterior à data published_at[min]. A data deve estar no formato YYYY-MM-DD. Exemplo: 2025-05-15

  • published_at[min]
    Tipo: string

    Define o limite inferior do intervalo de datas que você deseja pesquisar. Use este parâmetro em conjunto com o parâmetro published_at[max]. Esta data deve ser anterior à data published_at[max]. A data deve estar no formato YYYY-MM-DD. Exemplo: 2025-02-15

Respostas
  • 200
    Tipo: object

    Resposta bem-sucedida

    • news_articles
      Tipo: array string[]

      Array de resposta

    • pagination
      Tipo: object

      Objeto de resposta

    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/apollo/news_articles/search
curl 'https://openapi.felo.ai/v1/beta/apollo/news_articles/search?organization_ids[]=' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "pagination": {},
  "news_articles": [
    "string"
  ]
}
News Articles Search