Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Apollo
v0.2.0-beta
OpenAPI 3.1.0

البحث في المقالات الإخبارية

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

Apollo

​

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

Apollo العمليات

البحث في المقالات الإخبارية

​

تغطية إخبارية لشركات محددة. 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