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

جستجوی ایمیل WaveInflu

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

Creator Data

​

Creator discovery and public contact information.

Creator Data عملیات

جستجوی ایمیل WaveInflu

​

اطلاعات تماس یک نمایه سازنده را جستجو می‌کند. profile_url را بفرستید. پاسخ شامل requestId، billingRequestId و data با platform، profile_url و یک شیء email شامل status و value است. ایمیل not_found با مقدار null یک نتیجه جستجوی معتبر است. billingRequestId ارجاع ارائه‌دهنده است، نه رسید صورت‌حساب Felo.

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

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

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

بدنه
الزامی
application/json
  • profile_url
    نوع: string
پاسخ‌ها
  • 200
    نوع: object

    جستجوی ایمیل کامل شد

    • billingRequestId
      نوع: string

      مرجع صورت‌حساب ارائه‌دهنده، نه رسید صورت‌حساب Felo.

    • data
      نوع: object · ResponseEb32A34A5274_EmailLookupData
      • email
        نوع: object · ResponseEb32A34A5274_EmailResult
        • status
          نوع: string

          نتیجه جست‌وجو: found هنگام یافتن نشانی، در غیر این صورت وضعیت یافت‌نشد. نتیجه یافت‌نشد عادی است و همچنان به‌عنوان یک جست‌وجوی معتبر محاسبه می‌شود.

        • value
          نوع: string | null

          ایمیل اصلی تماس، یا null در صورت یافت‌نشدن.

      • platform
        نوع: string

        پلتفرم استخراج‌شده از نشانی URL پروفایل: instagram، tiktok یا youtube.

      • profile_url
        نوع: string

        نشانی URL نرمال‌شده پروفایل سازنده که در این جست‌وجو استفاده شد.

    • requestId
      نوع: string

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

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/waveinflu/email-lookup
curl --request POST https://openapi.felo.ai/v1/beta/waveinflu/email-lookup \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"profile_url": "https://www.youtube.com/@example-creator"}'
{
  "requestId": "example-request",
  "billingRequestId": "example-provider-billing",
  "data": {
    "platform": "youtube",
    "profile_url": "https://www.youtube.com/@example-creator",
    "email": {
      "status": "not_found",
      "value": null
    }
  }
}
WaveInflu Email Lookup