v0.2.0-beta

OpenAPI 3.1.0

מגמת תעבורת אתר

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

Website Analytics

Website traffic, engagement, audience, rankings and search data.

Website Analytics פעולות

get/v1/beta/similarweb/website-traffic-trend

מגמת תעבורת אתר

סדרת זמן חודשית של תעבורה לדומיין בחלון הזמין האחרון (data.points, רשומה אחת לחודש). החלון נבחר אוטומטית ומוחזר ב-meta.start_date / meta.end_date.

מראה תמחור

מדידה: יחידות משאב של התוכנית.
אומדן בקשת ייחוס: 0.45 דולר ארה״ב.
בסיס עלות ליחידה: 0.075 דולר ארה״ב.
יחידת משאב: similarweb_credit.
מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
בסיסי עלות אינם קובעים את מחיר הלקוח הסופי, גם כשהם אפס.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

פרמטרי שאילתה

country
enum
const:
ww

נתוני עולם בלבד; הערכים אינם תלויי רישיות.
ערכים
- ww
domain
סוג: string
חובה

שם מארח של אתר בלבד, ללא scheme, path, port או credentials.
end_date
סוג: string

החודש המלא האחרון לפי UTC בפורמט YYYY-MM, כולל.
metrics
סוג: string

מדד אחד עד ארבעה ממדדי Traffic & Engagement הנתמכים. מפריד פריטים: ,. פריטים מותרים: average_visit_duration, bounce_rate, new_users, page_views, pages_per_visit, returning_users, unique_visitors, visits. לכל היותר 4 פריטים מופרדים.
start_date
סוג: string

החודש הראשון בפורמט YYYY-MM, כולל; יש לספק יחד עם end_date.

תגובות

200
סוג: object

תגובה מוצלחת מנורמלת
data
סוג: object
חובה
domain
סוג: string
חובה
metrics
סוג: array string[] 1…4 ייחודי!enum
חובה
ערכים
average_visit_duration
bounce_rate
new_users
page_views
pages_per_visit
returning_users
unique_visitors
visits
points
סוג: array object[] 1…
חובה
month
סוג: string
חובה
values
סוג: object
חובה
average_visit_duration
סוג: number | null
bounce_rate
סוג: number | null
new_users
סוג: number | null
page_views
סוג: number | null
pages_per_visit
סוג: number | null
returning_users
סוג: number | null
unique_visitors
סוג: number | null
visits
סוג: number | null
meta
סוג: object
חובה
country
enum
const:
ww
חובה
ערכים
ww
end_date
סוג: string
חובה
granularity
const:
monthly
חובה
request_id
סוג: string
חובה
retrieved_at
סוג: string פורמט: date-time
חובה

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

source
const:
similarweb
חובה
start_date
סוג: string
חובה
application/json
400

לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
401

נדרש מפתח API תקף של Felo.
402

לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
403

החשבון אינו מורשה לבצע את הפעולה הזו.
429

הגעתם למגבלת בקשות או לתקרת הוצאה.
502

השירות לא הצליח להשלים את הבקשה.
503

שירות ה-API או החיוב אינו זמין באופן זמני.
504

השירות פג בזמן הטיפול בבקשה.
default

תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

application/json

get/v1/beta/similarweb/website-traffic-trend

curl 'https://openapi.felo.ai/v1/beta/similarweb/website-traffic-trend?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

הצגת סכמה

{
  "data": {
    "domain": "string",
    "metrics": [
      "average_visit_duration"
    ],
    "points": [
      {
        "month": "string",
        "values": {
          "average_visit_duration": null,
          "bounce_rate": null,
          "new_users": null,
          "page_views": null,
          "pages_per_visit": null,
          "returning_users": null,
          "unique_visitors": null,
          "visits": null
        }
      }
    ]
  },
  "meta": {
    "country": "ww",
    "end_date": "string",
    "granularity": "monthly",
    "request_id": "string",
    "retrieved_at": "2026-10-26T08:08:16.678Z",
    "source": "similarweb",
    "start_date": "string"
  }
}

תגובה מוצלחת מנורמלת

מגמת תעבורת אתר

אימותRequired

Website Analytics

מגמת תעבורת אתר

מראה תמחור