Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

News Articles Search

サーバー:https://openapi.felo.ai
クライアントライブラリ

Apollo

​

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

News Articles Search

​

News coverage for specific companies. organization_ids[] is required — omitting it returns HTTP 422 with "organization_ids is required", so resolve the companies first with get_apollo_organizations_enrich. Narrow further with categories[] (funding, hires, launches and similar), published_at[min], published_at[max], and page with page and per_page. Returns news_articles and pagination. Use it to catch a trigger event before reaching out. Requires Felo administrative permission.

クエリパラメーター
  • organization_ids[]
    型: array string[]
    必須

    The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, call the Organization Search endpoint and identify the values for organization_id. Example: 5e66b6381e05b4008c8331b8

  • categories[]
    型: array string[]

    Filter your search to include only certain categories or sub-categories of news. Use the News search filter for companies within Apollo to uncover all possible categories and sub-categories. Examples: hires; investment; contract

  • published_at[min]
    型: string

    Set the lower bound of the date range you want to search. Use this parameter in combination with the published_at[max] parameter. This date should fall before the published_at[max] date. The date should be formatted as YYYY-MM-DD. Example: 2025-02-15

  • published_at[max]
    型: string

    Set the upper bound of the date range you want to search. Use this parameter in combination with the published_at[min] parameter. This date should fall after the published_at[min] date. The date should be formatted as YYYY-MM-DD. Example: 2025-05-15

  • page
    型: integer

    The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the per_page parameter to make search results for navigable and improve the performance of the endpoint. Example: 4

  • per_page
    型: integer

    The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the page parameter to search the different pages of data. Example: 10

レスポンス
  • 200
    型: object

    Successful response

    • news_articles
      型: array string[]

      Response array

    • pagination
      型: object

      Response object

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

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