Felo API PlatformFelo API Platform
همه endpointهای Apollo
v0.2.0-beta
OpenAPI 3.1.0

جستجوی مقالات خبری

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

Apollo

​

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

جستجوی مقالات خبری

​

پوشش خبری برای شرکت‌های مشخص. organization_ids[] الزامی است — حذف آن HTTP 422 با "organization_ids is required" برمی‌گرداند، پس ابتدا شرکت‌ها را با get_apollo_organizations_enrich مشخص کنید. با categories[] (تأمین مالی، استخدام، عرضه محصول و موارد مشابه)، published_at[min]، published_at[max] محدودتر کنید و با page و per_page صفحه‌بندی کنید. news_articles و pagination را برمی‌گرداند. از آن برای گرفتن یک رویداد محرک پیش از تماس استفاده کنید. نیازمند مجوز مدیریتی Felo است.

مرجع قیمت‌گذاری

  • اندازه‌گیری: واحدهای منابع طرح.
  • برآورد درخواست مرجع: 0.01975 دلار آمریکا.
  • مبنای هزینه واحد: 0.0 دلار آمریکا.
  • واحد منبع: provider_credit.
  • ضریب مشتری مرجع: 1.0. ضریب‌های مرجع را نباید دوباره روی مبالغ تسویه‌شده مشتری اعمال کرد.
  • مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.

فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو
  • categories[]
    نوع: array string[]

    جستجوی خود را طوری فیلتر کنید که فقط دسته‌ها یا زیردسته‌های مشخصی از اخبار را شامل شود. از فیلتر جستجوی اخبار برای شرکت‌های داخل Apollo استفاده کنید تا همه دسته‌ها و زیردسته‌های ممکن را بیابید. نمونه‌ها: hires; investment; contract

  • organization_ids[]
    نوع: array string[]
    الزامی

    شناسه‌های Apollo شرکت‌هایی که می‌خواهید در نتایج جستجو بگنجانید. به هر شرکت در پایگاه داده Apollo شناسه‌ای یکتا اختصاص می‌یابد. برای یافتن شناسه‌ها، نقطه پایانی Organization Search را فراخوانی کنید و مقادیر organization_id را مشخص کنید. نمونه: 5e66b6381e05b4008c8331b8

  • page
    نوع: integer

    شماره صفحه داده‌های Apollo که می‌خواهید بازیابی کنید. از این پارامتر همراه با پارامتر per_page استفاده کنید تا نتایج جستجو قابل پیمایش شوند و عملکرد نقطه پایانی بهتر شود. نمونه: 4

  • per_page
    نوع: integer

    تعداد نتایج جستجویی که باید در هر صفحه بازگردانده شود. محدودکردن تعداد نتایج در هر صفحه عملکرد نقطه پایانی را بهبود می‌دهد. از پارامتر page برای جابه‌جایی بین صفحه‌های مختلف داده استفاده کنید. نمونه: 10

  • published_at[max]
    نوع: string

    حد بالای بازه تاریخی مورد جستجو را تعیین کنید. از این پارامتر همراه با پارامتر published_at[min] استفاده کنید. این تاریخ باید بعد از تاریخ published_at[min] باشد. تاریخ باید به قالب YYYY-MM-DD باشد. نمونه: 2025-05-15

  • published_at[min]
    نوع: string

    حد پایین بازه تاریخی مورد جستجو را تعیین کنید. از این پارامتر همراه با پارامتر published_at[max] استفاده کنید. این تاریخ باید قبل از تاریخ published_at[max] باشد. تاریخ باید به قالب YYYY-MM-DD باشد. نمونه: 2025-02-15

پاسخ‌ها
  • 200
    نوع: object

    پاسخ موفق

    • news_articles
      نوع: array string[]

      آرایه پاسخ

    • pagination
      نوع: object

      شیء پاسخ

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    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