Felo API PlatformFelo API Platform

データ API / Apollo / News Articles

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[]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[]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

  • pageinteger任意

    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_pageinteger任意

    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

リクエスト例

curl -G "https://openapi.felo.ai/v1/beta/apollo/news_articles/search" \
  --data-urlencode "organization_ids[]=<string[]>" \
  -H "Authorization: Bearer $FELO_API_KEY"

レスポンス

レスポンスのフィールド

  • paginationobject任意

    Response object

  • news_articlesstring[]任意

    Response array