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