תיעוד v1 API

מידע על שיטות נתמכות, פרמטרים, נתונים שהוחזרו ודוגמאות.

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

סקירה

ניתן להשתמש ב- API של TLD-List v1 כדי לאחזר נתונים המוצגים ב- TLD-List ממסד הנתונים החי שלו.

ה- API מקבל ומחזיר נתונים מקודדים של JSON באמצעות HTTP POSTs. דרישות עבור כל בקשות השיטה של API:

  • [
  • "
  • ב
  • ק
  • ש
  • ו
  • ת
  • ח
  • י
  • י
  • ב
  • ו
  • ת
  • ל
  • ה
  • ת
  • ב
  • צ
  • ע
  • ב
  • א
  • מ
  • צ
  • ע
  • ו
  • ת
  • ש
  • י
  • ט
  • ת
  • H
  • T
  • T
  • P
  • P
  • O
  • S
  • T
  • "
  • ,
  • "
  • ב
  • ק
  • ש
  • ו
  • ת
  • ח
  • י
  • י
  • ב
  • ו
  • ת
  • ל
  • כ
  • ל
  • ו
  • ל
  • ג
  • ו
  • ף
  • J
  • S
  • O
  • N
  • ה
  • מ
  • כ
  • י
  • ל
  • ז
  • ו
  • ג
  • מ
  • פ
  • ת
  • ח
  • ו
  • ת
  • A
  • P
  • I
  • צ
  • י
  • ב
  • ו
  • ר
  • י
  • ו
  • פ
  • ר
  • ט
  • י
  • ח
  • ו
  • ק
  • י
  • ל
  • א
  • י
  • מ
  • ו
  • ת
  • "
  • ,
  • "
  • ב
  • ק
  • ש
  • ו
  • ת
  • ח
  • י
  • י
  • ב
  • ו
  • ת
  • ל
  • כ
  • ל
  • ו
  • ל
  • א
  • ת
  • ה
  • כ
  • ו
  • ת
  • ר
  • ת
  • :
  • <
  • c
  • o
  • d
  • e
  • >
  • C
  • o
  • n
  • t
  • e
  • n
  • t
  • -
  • T
  • y
  • p
  • e
  • :
  • a
  • p
  • p
  • l
  • i
  • c
  • a
  • t
  • i
  • o
  • n
  • /
  • j
  • s
  • o
  • n
  • <
  • /
  • c
  • o
  • d
  • e
  • >
  • "
  • ]

פרמטרים מועברים ל- API כמפתח/ערכים בגוף הבקשה המקודד JSON.

כתובת ה- URL המשמשת כבסיס עבור כל בקשות ה- API היא:

https://api.tld-list.com/v1

אימות

האימות מתבצע על-ידי העברת מפתח API ציבורי ומפתח API פרטי בגוף JSON המוצב בכתובת ה- URL של השיטה. כל שיחות ה- API חייבות לכלול צירוף מפתחות API חוקי. ניתן ליצור צמדי מפתחות API בחשבון TLD-List שלך תחת לשונית API .

בקר בדף Account > API כדי ליצור מפתחות API.

מפתחות API מועברים בגוף הבקשה JSON באמצעות הפרמטרים apiKeyPublic (המפתח הציבורי שלך) ו- apiKeyPrivate (המפתח הפרטי שלך).

Example authentication parameters

{
    "apiKeyPublic":"MY_PUBLIC_KEY",
    "apiKeyPrivate":"MY_PRIVATE_KEY" 
}

תגובה

כל תגובות ה- API המוצלחות יכללו 200 SUCCESS קוד מצב HTTP וגוף מקודד JSON. כל קוד מצב HTTP אחר בתגובה מציין שהבקשה נכשלה ואירעה שגיאה.

כל אובייקט התגובה JSON שיוחזר על-ידי ה- API יכלול את המבנה הבא:

מפתח סוג תיאור
status string מציין את מצב הבקשה. SUCCESS מציין ששיחת ה- API בוצעה בהצלחה, FAIL מציין שהבקשה נכשלה.
errors array of objects מערך של אובייקטים המייצגים את השגיאות שאירעו. כל אובייקט שגיאה יכיל:

codeמחרוזת המזהה את סוג השגיאה:

messageמחרוזת הניתנת לקריאה על-ידי בני אדם המתארת את השגיאה:

parameterמחרוזת אופציונלית המציינת בעיה בפרמטר מסוים שהועבר בבקשה.:

אם לא אירעו שגיאות, המערך errors יהיה ריק.
seconds number משך הזמן שלקח לשרת ה- API ליצור תגובה (בשניות).
data string|array|object אובייקט, מערך או מחרוזת המכילים את הנתונים המבוקשים.

דוגמה לאובייקט תגובה שנכשל שנכשל עם שגיאות

{
   "errors" : [
      {
         "code" : "PARAMETER_INVALID",
         "message" : "pricetypes parameter must be a non-empty array",
         "parameter" : "pricetypes"
      },
      {
         "code" : "PARAMETER_INVALID",
         "message" : "includeRegistrars parameter contains invalid registrar names: foobar",
         "parameter" : "includeRegistrars"
      }
   ],
   "seconds" : 0.001,
   "status" : "FAIL"
}

דוגמה לאובייקט תגובה מוצלחת

{
   "data" : [
      {
         "cheapest" : {
            "renewal" : [
               {
                  "id" : "sav",
                  "name" : "Sav",
                  "price" : "8.38"
               }
            ],
         },
         "currency" : "USD",
         "name" : "com",
         "registrarsIncluded" : 58,
         "registrarsTotal" : 58
      }
   ],
   "errors" : [],
   "seconds" : 0.001,
   "status" : "SUCCESS"
}

אובייקטי תגובה נפוצים

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

RegistrarPricing

מתאר את התמחור הקמעונאי של רשם עבור הרחבה עבור סוג מחיר מסוים (register, renewal, transfer), כולל פרטים נוספים כגון תנאים מיוחדים, עמלות, מס ומבצעים.

נתיב סוג תיאור
id string מחרוזת מזהה רשם המזהה באופן ייחודי את הרשם.
name string שם התצוגה של הרשם.
price string המחיר הקמעונאי של הרשם עבור ההרחבה כמחרוזת מספרית.
priceOriginal string המחיר הקמעונאי הרגיל של הרשם עבור הסיומת כמחרוזת מספרית. שדה זה יהיה קיים רק אם price הוא מחיר מבצע.

הערה: שדה זה קיים רק כאשר האובייקט RegistrarPricing מקונן בהקשר של pricetype (לדוגמה, בתגובה מ - getCheapestRegistrars).
pricetype string סוג תמחור ההרחבה, אחד מתוך: register, renewal, transfer.
prices object התמחור הקמעונאי של הרשם להרחבה לכל סוגי המחירים.
prices[pricetype] string המחיר הקמעונאי הסופי של הרשם עבור ההרחבה ו- [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy. דוגמה:

__לדוגמה__
pricesOriginal object התמחור הקמעונאי הרגיל של הרשם להרחבה לכל סוגי המחירים. שדה זה לא יהיה קיים אם לרשם אין פעיל promos.
pricesOriginal[pricetype] string המחיר הקמעונאי הרגיל של הרשם עבור ההרחבה ו- [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
promo object אובייקט המייצג תמחור קידום מכירות שהוחל על מחיר הרשם עבור הרחבה זו. אם לא הוחל קידום מכירות, שדה זה לא יהיה קיים. אובייקט פרומו לדוגמה: 

__לדוגמה__
promos array of objects מערך אובייקטי רשםפרומו המייצגים את כל מחירי המבצע הפעילים המוצעים על ידי הרשם עבור הרחבה זו.
terms object אוסף של אובייקטים המייצגים תנאים מיוחדים החלים על תמחור הרשם. אם לא חלים תנאים מיוחדים, שדה זה לא יהיה קיים. כל אובייקט משנה מפתח עם מזהה מונח:

limitPerCustomer - מציין כי התמחור תקף רק עבור מספר מסוים של דומיינים לכל לקוח.
newCustomerOnly - מציין כי התמחור תקף רק עבור לקוחות חדשים.
affiliateLink - מציין כי התמחור תקף רק כאשר הלקוח ניגש לאתר הרשם באמצעות קישור שותפים.
nameserverLockIn - מציין כי דומיינים שנרכשו יכולים להשתמש רק בשרתי השמות של הרשם.
idSubmissionRequired - מציין שהלקוח חייב לשלוח את מזהה התמונה או את רישום העסק שלו כדי להשלים רכישה.

אובייקטים של מונחים לדוגמה: 

__לדוגמה__
terms[term].count number הכמות שהמונח מגביל את הלקוח אליה. לדוגמה, אם count = 1, אז הלקוח מוגבל לדומיין אחד במחיר שצוין. שדה זה לא יהיה קיים אם הוא אינו חל.
terms[term].pricetype array of strings סוגי המחירים שהמונח חל עליהם: register, renewal, transfer. שדה זה יהיה קיים רק אם סוג המחיר של אובייקט RegistrarPricing לא צוין.
notes object אוסף של אובייקטים המייצגים פתקים הנוגעים לתמחור הרשם. אם אין הערות תמחור, ערך זה יהיה אובייקט ריק. כל אובייקט משנה מסומן במפתח עם מזהה הערה: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcann object מציין אם עמלת ICANN נוספה למחיר הסופי עבור TLD (בדרך כלל $0.18 USD). אם הערה זו קיימת, פירוש הדבר שהרשם אינו כולל את עמלת ICANN במחיר המפורסם שלהם, ובמקום זאת מוסיף אותה כתשלום נוסף למחיר TLD's בקופה ללקוח.

אובייקט הערה לדוגמה fee_icann : 

{
    "feeIcann": {
        "pricetype": [
            "register",
            "renewal",
            "transfer"
        ],
        "amount": "0.18",
        "addedToListPrice": true
    }
}

השדה pricetype מציין אילו סוגי מחירים כפופים לעמלה, והשדה addedToListPrice מציין שהעמלה נוספה למחיר הסופי.
notes.feeTax array of objects מפרט את שיעורי המס השונים הנגבים על ידי רשם, את הלקוחות שעליהם חל המס ואם המס המחושב נכלל במחיר הסופי של ה- TLD. אנא שימו לב כי מסים כלולים במחיר הסופי של ה-TLD רק אם הרשם אינו כולל את המס במחירים המפורסמים שלו והמס מחויב לכל הלקוחות.

מערך אובייקטים לדוגמה feeTax : 

{
    "feeTax": [
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "eu",
                "us",
                "in"
            ],
            "amountRateType": "percent",
            "amountRate": "13",
            "type": "hst"
        },
        {
            "addedToListPrice": false,
            "appliesToCustomers": [
                "ca"
            ],
            "amountRateType": "percent",
            "amountRate": "5",
            "type": "gst"
        }
    ]
}
notes.feeTax[].type string תווית המתארת את סוג המס, כלומר 'vat' מס ערך מוסף, 'gst' מס סחורות ושירותים וכו'.
notes.feeTax[].amountRate number|string סכום שיעור המס. פעולה זו תהיה שיעור אחוז המס כמספר, או המחרוזת '~' המציינת ששיעור המס משתנה בהתאם לקריטריונים של הלקוח, כגון מיקום.
notes.feeTax[].amountRateType string ערך 'percent' המחרוזת מציין שהערך amountRate הוא אחוז מספרי. ערך 'percent-varies-by-location' המחרוזת מציין ששיעור המס משתנה בהתאם לאזור החיוב או למדינה של הלקוח.
notes.feeTax[].appliesToCustomers string|array of strings המחרוזת '*' מציינת שהמס חל על כל הלקוחות. אחרת, ערך זה יהיה מערך של מחרוזות קוד מדינה ISO 3166-1 alpha-2 המגדירות אילו מדינות כפופות למס. חריג אחד שראוי לציין: המערך עשוי להכיל את מחרוזת 'eu'הקוד שאינה מדינה , המייצגת את כל המדינות באיחוד האירופי.
notes.feeTax[].addedToListPrice boolean מציין אם סכום המס המחושב נוסף למחיר הסופי.
notes.feePayment object מציין אם הרשם גובה תשלום נוסף בהתבסס על שיטת התשלום של הלקוח, ואם העמלה נכללה במחיר הסופי עבור ה- TLD.
אובייקט לדוגמה feePayment : 

{
    "feePayment": {
        "addedToListPrice": false,
        "amountRate": "~",
        "amountRateMin": "0.9",
        "amountRateMax": "20",
        "amountRateType": "percent-varies-by-method"
    }
}
notes.feePayment.amountRate string סכום העמלה. זה יהיה שיעור אחוז העמלה כמספר, או המחרוזת '~' המציינת ששיעור העמלה משתנה בהתאם לקריטריונים של הלקוח, כגון אמצעי תשלום.
notes.feePayment.amountRateMin string סכום העמלה המינימלי, חל רק אם העמלה משתנה.
notes.feePayment.amountRateMax string סכום העמלה המרבי, חל רק אם העמלה משתנה.
notes.feePayment.amountRateType string ערך 'percent' המחרוזת מציין שהערך amountRate הוא אחוז מספרי. ערך 'percent-varies-by-method' המחרוזת מציין שהעמלה היא אחוז המשתנה בהתאם לשיטת התשלום של הלקוח.
notes.feePayment.addedToListPrice boolean מציין אם סכום העמלה המחושב נוסף למחיר הסופי.
notes.currencyExchangeRate object מציין שמחירי הרשם נרשמו במטבע לאומי אחר, והומרו ל- USD. פרטי המרת המטבע מיוצגים כ:

baseמטבע התמחור של הרשם כקוד בן 3 אותיות (כלומר אירו).:
quoteהמטבע שאליו הומרו המחירים (תמיד יהיה USD)::
rateשער החליפין המשמש לביצוע המרת המטבע.:

אובייקט הערה לדוגמה currencyExchangeRate : 

{
    "currencyExchangeRate": {
        "base": "GBP",
        "quote": "USD",
        "rate": "1.2482"
    }
}
threeYearValueScore number מדידה מספרית של ערך, הנקבעת על ידי תמחור ותכונות חינמיות, עבור בעלות על דומיין עם סיומת זו באמצעות הרשם לתקופה של 3 שנים. ככל שהמספר גדול יותר, כך מוצע ערך רב יותר.
currency string קוד מטבע ISO 4217 בן שלוש אותיות של נתוני התמחור. ערך זה הוא כרגע רק USD.
freeFeatures array of objects מערך של אובייקטים המייצגים את התכונות החינמיות שהרשם מציע עם בעלות על דומיין. האובייקט כולל את הכמות ומשך הזמן של כל תכונה. לכל אובייקט מקודד מזהה תכונה חינמי:

dns - שירות DNS חינם.
whois-privacy - שירות הפרטיות WHOIS.
email-account - חשבונות דוא"ל ללא תשלום.
email-forward - העברת דוא"ל ללא תשלום.
ssl-cert - תעודות SSL בסיסיות ללא תשלום.

מערך תכונות חינמי לדוגמה: 

__לדוגמה__
freeFeatures[].count number כמות התכונה שהרשם מציע בחינם. שדה זה לא יהיה קיים אם הוא אינו חל.
freeFeatures[].duration number מספר הימים שהתכונה מוצעת בחינם על-ידי הרשם. אם , duration = 365אז התכונה מוצעת בחינם למשך שנה אחת. שדה זה לא יהיה קיים אם הוא אינו חל.

RegistrarPromo

מתאר קידום פעיל המוצע על-ידי רשם. דוגמה: 

__לדוגמה__
נתיב סוג תיאור
promo.code string קוד המבצע שעל הלקוח להזין בקופה כדי לקבל את המבצע המוזל.
promo.amount string הסכום המספרי של תמחור המבצע. בהתאם לסוג המבצע, זה יכול להיות המחיר המוזל (), הסכום שהופחת מהמחיר הרגיל (), או הסכום באחוזים שהופחת מהמחיר הרגיל (pricediscountdiscount-percent).
promo.type string מחרוזת המייצגת את סוג תמחור המבצע. יהיה אחד מהערכים הבאים:

price - כלומר שדה הסכום של המבצע הוא המחיר המוזל החדש
discount - פירושו ששדה סכום המבצע הופחת מהמחיר הרגיל כדי לקבל את המחיר המיושם
discount-percent - פירושו שדה הסכום של המבצע הוא אחוזים, והאחוז הופחת מהמחיר הרגיל כדי לקבל את המחיר החל.
promo.start string ISO 8601 datetime (אזור זמן UTC) של מתי המבצע התחיל. לא יהיה נוכח אם לא היה תאריך התחלה ספציפי. דוגמה: 2015-06-22T00:00:00
promo.end string ISO 8601 datetime (אזור זמן UTC) של מתי המבצע יסתיים. לא יהיה נוכח אם אין תאריך סיום ספציפי. דוגמה: 2025-06-22T00:00:00
promo.pricetype array of strings סוגי המחירים שעליהם חל המבצע: register, renewal, transfer.

הערה: שדה זה קיים רק כאשר הוא מקונן בהקשר של סוג מחיר (לדוגמה, בתגובה מ - getCheapestRegistrars).

קודי שגיאה

בעת כשל בבקשה, אובייקט התגובה JSON יכול להכיל אובייקט שגיאה אחד או יותר המתארים מה השתבש. להלן רשימה לא מקיפה של קודי שגיאה מזהים שניתן להגדיר בשדה של code אובייקט השגיאה.

קוד תיאור
502 שרת API אינו זמין באופן זמני.
RATE_LIMITED מספר בקשות ה- API של הלקוח חרג מהמותר לכל היותר.
INVALID_METHOD שיטת ה- API המבוקשת אינה קיימת.
SYSTEM אירעה שגיאת מערכת לא ידועה.
RESPONSE_TIMEOUT הזמן הקצוב לשרת API הסתיים בעת יצירת תגובה.
PARAMETER_REQUIRED פרמטר נדרש עבור השיטה שנקראה לא סופק על ידי הלקוח.
ACCOUNT_INACTIVE חשבון הלקוח אינו פעיל עוד ונדרש חידוש מנוי עבור גישת API.
NO_ACCESS רמת החשבון של הלקוח אינה מעניקה גישת API. נדרש שדרוג חשבון עבור גישת API.
AUTH_INVALID האימות נכשל: מפתחות ה- API שסופקו אינם פעילים או אינם חוקיים.
CLIENT_IPS_EXCEEDED בוצעה חריגה מכתובות ה- IP הייחודיות המרביות של לקוחות המורשים לגשת ל- API עבור זוג מקשי ה- API שסופק.
REQUEST_ENDED_BY_CLIENT הבקשה הופסקה על ידי הלקוח לפני שניתן היה לייצר תגובה.

מגבלות

השימוש ב- API כפוף למגבלות מסוימות כדי למנוע שימוש לרעה. מגבלות שימוש אלה מוצגות להלן וכפופות לשינוי ללא הודעה מוקדמת.

סוג תיאור
מפתחות API לכל חשבון 3
מגבלת תעריף 100 מקסימום בקשות לכל 15 דקות
כתובות IP של לקוח לכל מפתח API 5 כתובות IP ייחודיות של לקוח לכל מקש לכל 1440 דקות

שיטות הרחבה

get

מחזירה הרחבות ואת נתוני התמחור והפרטים המשויכים אליהן. שיטה זו דומה לאחזור הנתונים המוצגים בדף פרטי TLD אחד או יותר (לדוגמה, .com), למעט נתוני "היסטוריית המחירים הזולים ביותר", שאינם מוחזרים בשיטה זו (עיין בשיטת getAggregateHistory לנתונים היסטוריים).

נקודת קצה של API:https://api.tld-list.com/v1/extension/get

זמן תגובה:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

פרמטרים של בקשה

מפתח סוג חובה תיאור
extensions array of strings

מציין אילו הרחבות לאחזר. אל תכלול נקודה קודמת. שמות סיומות יכולים להיות unicode או המקבילה punycode שלהם. אם הושמט, כל ההרחבות המפורטות ב- TLD-List יוחזרו.

דוגמה: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeFields array of strings ציין נתונים מסוימים לחזרה לפי שם מפתח. מפתחות שלא נשלחו בפרמטר זה יושמטו. כברירת מחדל, כל השדות הזמינים מוחזרים. עיין בטבלת התגובות לקבלת רשימה של שדות זמינים. שדות מקוננים אינם נתמכים.

דוגמה: "includeFields": ["name", "registrars", "dnssecSupported"]
excludeFields array of strings ציין נתוני cetain שלא ייכללו לפי שם מפתח. מפתחות שנמסרו בפרמטר זה יושמטו. כברירת מחדל, שדות אינם נכללים. עיין בטבלת התגובות לקבלת רשימה של שדות זמינים. שדות מקוננים אינם נתמכים.

דוגמה: "excludeFields": ["available", "syntax", "sponsor"]
includeRegistrars array of strings

מזהי המחרוזות של רשמים פעילים שיש לכלול בתוצאות. השתמש בשיטה getIds כדי לקבל רשימה של מזהים של כל הרשמים הרשומים באופן פעיל ב- TLD-List.

דוגמה: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

מזהי המחרוזות של רשמים פעילים שיש לא לכלול בתוצאות. השתמש בשיטה getIds כדי לקבל רשימה של מזהים של כל הרשמים הרשומים באופן פעיל ב- TLD-List.

דוגמה: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

כאשר true, הרחבות שאין להן נתוני תמחור רשם בתוצאות מושמטות. כברירת מחדל, כל ההרחבות כלולות.

דוגמה: "omitExtensionsWithoutRegistrars": true

אובייקט תגובה

נתיב סוג תיאור
data array of objects מערך שמות סיומות.
data[].available object מושא תאריכי הזמינות של שלב הסיומת.
data[].available.general object ISO 8601 datetime (אזור זמן UTC) של מתי רישום דומיין זמין לציבור הרחב.
data[].available.sunrise object טווחי אובייקט start ותאריך end המייצגים את שלב TLD's Sunrise (כאשר בעלי סימן מסחרי יכולים להתחיל להגיש בקשה לרישום דומיינים רלוונטיים). דוגמה: 

__לדוגמה__
data[].available.trademark object טווח האובייקטים וזמני end התאריכים המייצג את שלב הסימן המסחרי TLD's (תקופה שבה בעלי סימן מסחרי יקבלו הודעה ממסלקת סימני המסחר אם רשום דומיין התואם start את הסימן שלהם). דוגמה:

__לדוגמה__
data[].available.other array of objects מערך של אובייקטים המייצגים שלבי שיגור שונים של הסיומת ואת טווחי הזמן שלהם, כגון "Land Rush" ו- "Qualified Launch Program". דוגמה: 

__לדוגמה__
data[].average object אובייקט המכיל את המחיר הממוצע של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים.
data[].average[pricetype] string המחיר הממוצע של הסיומת כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
data[].category string הקטגוריות שהסיומת סווגה תחתן. כל אובייקט במערך מייצג קטגוריה ומכיל את השדות הבאים:

id - מזהה קטגוריה של מספר שלם המשמש באופן פנימי על ידי TLD-List.
idstr - מזהה קטגוריית מחרוזת חלופית.
name - שם קטגוריה באנגלית.
desc - תיאור קטגוריה באנגלית.

מערך קטגוריות לדוגמה: 

__לדוגמה__
data[].dnssecSupported boolean אם אזור ה- DNS של הרישום תומך ב- DNS Security Extensions (DNSSEC).
data[].hasPremiumDomains object אובייקט של מפתחות [pricetype] וערכים בוליאניים, המייצגים אם הרישום גובה מחירים גבוהים יותר עבור שמות מתחם נבחרים מסוג "Premium". דוגמה: 

__לדוגמה__
data[].infoUpdated string ISO 8601 datetime (אזור זמן UTC) של מתי המידע הבסיסי TLD's (הגבלות, תאריכי זמינות וכו ') נבדק ועודכן לאחרונה. הערה: תאריך חדש updated.info אינו מעיד בהכרח על כך שהתרחש שינוי כלשהו בנתונים. הוא מציין רק מתי הנתונים נבדקו והוגדרו לאחרונה.
data[].intendedUsage string מידע כללי על אופן השימוש בהרחבה על ידי הנרשמים.
data[].language string קוד השפה ISO 639-1 2 תווים. אם השפה מבוססת אנגלית או לא ידועה, שדה זה לא יהיה קיים.
data[].level integer מספר שלם המייצג את רמת התחום של הסיומת. 1 = תחום ברמה העליונה, 2 = תחום ברמה שנייה, 3 = תחום ברמה שלישית וכו'.
data[].localPresenceRequired boolean אם הרישום דורש מהנרשם כתובת פיזית מקומית לאזור.
data[].median object אובייקט המכיל את המחיר החציוני של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים.
data[].median[pricetype] string המחיר החציוני של הסיומת כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer, restore, whoisprivacy.
data[].name string שם Unicode של סיומת התחום.
data[].nameservers array שרתי שמות הבסיס של הרישום המאחסנים את שרתי השמות המוסמכים של הדומיינים הרשומים. מערך שרתי שמות לדוגמה: 

__לדוגמה__
data[].parentTld string דומיין האב ברמה העליונה של התוסף. אם זהו TLD, שדה זה לא יהיה קיים.
data[].pricingUpdated string ISO 8601 datetime (אזור זמן UTC) של המועד שבו תמחור רשם TLD's נבדק ועודכן לאחרונה. הערה: תאריך חדש updated.pricing אינו מעיד בהכרח על כך שהתרחש שינוי כלשהו בנתונים. הוא מציין רק מתי הנתונים נבדקו והוגדרו לאחרונה.
data[].punycode string שם Punycode של סיומת התחום. קיים רק עבור הרחבות IDN.
data[].registerMaxYears integer מקסימום שנים שניתן לרשום דומיין בעת רכישתו.
data[].registerMinYears integer מינימום שנים בהן ניתן לרשום דומיין בעת הרכישה.
data[].registrarsIncluded integer ספירת הרשמים הכלולים במערך שהוחזר registrars .
data[].registrarsTotal integer סה"כ רשמים פעילים שמוכרים את ההרחבה.
data[].registrars array of objects מערך אובייקט(י) RegistrarPricing המכיל נתוני תמחור ותכונות של רשם.
data[].registryUrl string האתר הרשמי של הרישום למידע על רישום TLD.
data[].renewalMinYears integer מינימום השנים המותרות שניתן לחדש דומיין.
data[].restrictions string תיאור קצר של הגבלות ודרישות הרישום TLD's. אם אין הגבלות, שדה זה לא יהיה קיים
data[].sponsor object אובייקט המכיל נתונים על הארגון נותן החסות של ההרחבה או הארגון הניהולי.
data[].sponsor.name string שם הארגון נותן החסות המאושר על ידי ICANN או ארגון הניהול ccTLD.
data[].sponsor.address string מיקום פיזי של הארגון נותן החסות או ארגון הניהול ccTLD. מערך כתובות לדוגמה: 

__לדוגמה__
data[].sponsorParentCompany string שם הגוף בעל השליטה בארגון נותן החסות.
data[].romanized string הסיומת תועתקה לתווים לטיניים. אם השפה מבוססת אנגלית, או לא ידועה, שדה זה לא יהיה קיים.
data[].rtl string אם הסיומת נקראת "מימין לשמאל" (כלומר. Arabric TLDs), ערך זה יהיה __true__. אם הוא נקרא מ "משמאל לימין", ערך זה יהיה __false__. אם לא ידוע, ערך זה לא יהיה קיים.
data[].syntax object אובייקט המכיל פרטים על הכללים וההגבלות המותרים של שם המתחם של הסיומת.
data[].syntax.minChars integer מספר מינימלי של תווים בתווית מותר להירשם.
data[].syntax.maxChars integer מספר התווים המרבי בתווית מותר לרישום.
data[].targetMarket string האנשים או הישויות שהסיומת נועדה לשרת.
data[].translation string התרגום לאנגלית של הסיומת. אם הסיומת כבר מבוססת אנגלית, או שהתרגום אינו ידוע, ערך זה לא יהיה קיים.
data[].type string סוג הסיומת המזוהה על-ידי אחת מהמחרוזות הבאות:

gTLD: תחום כללי ברמה העליונה.
ccTLD: דומיין ברמה העליונה של קידומת מדינה.
grTLD: תחום ברמה העליונה עם הגבלה גנרית.
sTLD: דומיין ממומן ברמה העליונה.
data[].wholesale object אובייקט המכיל את המחירים הסיטונאיים של ההרחבה לפי סוג מחיר. מחירים סיטונאיים הם המחירים שגובה המרשם מרשם עבור רכישת שמות מתחם.
data[].whoisPrivacySupported boolean אם ההרחבה מאפשרת לשירותי הפרטיות של WHOIS להסוות את שמות הנרשמים ואת פרטי הקשר שלהם. אם לא ידוע, שדה זה לא יהיה נוכח.
data[].whoisServer boolean שם מארח של שרת הרישום המאחסן פרטי קשר של נרשם תחום.

בקשה/תגובה לדוגמה

curl -X POST https://api.tld-list.com/v1/extension/get -H 'Content-Type: application/json' -d '{"extensions": ["com"], "includeRegistrars": ["porkbun","godaddy","epik"], "apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"}'

{
   "data" : [
      {
         "average" : {
            "register" : "7.63",
            "renewal" : "13.63",
            "transfer" : "9.63"
         },
         "clicks" : 226,
         "dnssecSupported" : true,
         "hasPremiumDomains" : {
            "register" : false,
            "renewal" : false
         },
         "infoUpdated" : "2023-02-04T11:05:09",
         "level" : 1,
         "localPresenceRequired" : false,
         "median" : {
            "register" : "3.17",
            "renewal" : "20.17",
            "transfer" : "8.17"
         },
         "name" : "com",
         "nameservers" : [
            {
               "host" : "a.gtld-servers.net",
               "ipv4" : "192.5.6.30",
               "ipv6" : "2001:503:a83e:0:0:0:2:30"
            },
            {
               "host" : "b.gtld-servers.net",
               "ipv4" : "192.33.14.30",
               "ipv6" : "2001:503:231d:0:0:0:2:30"
            },
            {
               "host" : "c.gtld-servers.net",
               "ipv4" : "192.26.92.30",
               "ipv6" : "2001:503:83eb:0:0:0:0:30"
            },
            {
               "host" : "d.gtld-servers.net",
               "ipv4" : "192.31.80.30",
               "ipv6" : "2001:500:856e:0:0:0:0:30"
            },
            {
               "host" : "e.gtld-servers.net",
               "ipv4" : "192.12.94.30",
               "ipv6" : "2001:502:1ca1:0:0:0:0:30"
            },
            {
               "host" : "f.gtld-servers.net",
               "ipv4" : "192.35.51.30",
               "ipv6" : "2001:503:d414:0:0:0:0:30"
            },
            {
               "host" : "g.gtld-servers.net",
               "ipv4" : "192.42.93.30",
               "ipv6" : "2001:503:eea3:0:0:0:0:30"
            },
            {
               "host" : "h.gtld-servers.net",
               "ipv4" : "192.54.112.30",
               "ipv6" : "2001:502:8cc:0:0:0:0:30"
            },
            {
               "host" : "i.gtld-servers.net",
               "ipv4" : "192.43.172.30",
               "ipv6" : "2001:503:39c1:0:0:0:0:30"
            },
            {
               "host" : "j.gtld-servers.net",
               "ipv4" : "192.48.79.30",
               "ipv6" : "2001:502:7094:0:0:0:0:30"
            },
            {
               "host" : "k.gtld-servers.net",
               "ipv4" : "192.52.178.30",
               "ipv6" : "2001:503:d2d:0:0:0:0:30"
            },
            {
               "host" : "l.gtld-servers.net",
               "ipv4" : "192.41.162.30",
               "ipv6" : "2001:500:d937:0:0:0:0:30"
            },
            {
               "host" : "m.gtld-servers.net",
               "ipv4" : "192.55.83.30",
               "ipv6" : "2001:501:b1f9:0:0:0:0:30"
            }
         ],
         "pricingUpdated" : "2023-02-04T11:04:33",
         "registerMaxYears" : 10,
         "registerMinYears" : 1,
         "registrars" : [
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "dns"
                  },
                  {
                     "name" : "whois-privacy"
                  }
               ],
               "id" : "godaddy",
               "name" : "GoDaddy",
               "notes" : {
                  "feeIcann" : {
                     "addedToListPrice" : true,
                     "amount" : "0.18",
                     "pricetype" : [
                        "register",
                        "renewal",
                        "transfer"
                     ]
                  },
                  "feeTax" : [
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "~",
                        "amountRateType" : "percent-varies-by-location",
                        "appliesToCustomers" : [
                           "eu"
                        ],
                        "type" : "vat"
                     },
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "15",
                        "amountRateType" : "percent",
                        "appliesToCustomers" : [
                           "in"
                        ],
                        "type" : "gst"
                     },
                     {
                        "addedToListPrice" : false,
                        "amountRate" : "10",
                        "amountRateType" : "percent",
                        "appliesToCustomers" : [
                           "au"
                        ],
                        "type" : "gst"
                     }
                  ]
               },
               "prices" : {
                  "register" : "3.17",
                  "renewal" : "20.17",
                  "transfer" : "8.17",
                  "whoisPrivacy" : "0.00"
               },
               "pricesOriginal" : {
                  "register" : "10.18"
               },
               "promos" : [
                  {
                     "amount" : "2.99",
                     "code" : "GDD2dom",
                     "pricetype" : [
                        "register"
                     ],
                     "start" : "2023-01-01T00:00:00",
                     "type" : "price"
                  }
               ],
               "terms" : {
                  "limitPerCustomer" : {
                     "count" : 1,
                     "pricetype" : [
                        "register"
                     ]
                  }
               },
               "threeYearValueScore" : "5.76"
            },
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "whois-privacy"
                  },
                  {
                     "name" : "dns"
                  }
               ],
               "id" : "epik",
               "name" : "Epik",
               "prices" : {
                  "register" : "9.99",
                  "renewal" : "10.99",
                  "restore" : "90.00",
                  "transfer" : "9.99",
                  "whoisPrivacy" : "0.00"
               },
               "threeYearValueScore" : "8.29"
            },
            {
               "currency" : "USD",
               "freeFeatures" : [
                  {
                     "name" : "whois-privacy"
                  },
                  {
                     "name" : "dns"
                  },
                  {
                     "name" : "email-forward"
                  },
                  {
                     "name" : "ssl-cert"
                  }
               ],
               "id" : "porkbun",
               "name" : "Porkbun",
               "prices" : {
                  "register" : "8.73",
                  "renewal" : "9.73",
                  "transfer" : "9.73",
                  "whoisPrivacy" : "0.00"
               },
               "pricesOriginal" : {
                  "register" : "9.73"
               },
               "promos" : [
                  {
                     "amount" : "1.00",
                     "code" : "AWESOMENESS",
                     "pricetype" : [
                        "register"
                     ],
                     "type" : "discount"
                  }
               ],
               "terms" : {
                  "limitPerCustomer" : {
                     "count" : 1,
                     "pricetype" : [
                        "register"
                     ]
                  }
               },
               "threeYearValueScore" : "16.03"
            }
         ],
         "registryUrl" : "http://www.verisigninc.com",
         "renewalMinYears" : 1,
         "rtl" : false,
         "sponsor" : {
            "address" : [
               "12061 Bluemont Way",
               "Reston Virginia 20190",
               "United States"
            ],
            "name" : "VeriSign Global Registry Services"
         },
         "syntax" : {
            "maxChars" : 63,
            "minChars" : 2
         },
         "type" : "gTLD",
         "whoisPrivacySupported" : true,
         "whoisServer" : "whois.verisign-grs.com",
         "wholesale" : {
            "register" : "8.97",
            "renewal" : "8.97",
            "transfer" : "8.97"
         }
      }
   ],
   "errors" : [],
   "seconds" : 0.068,
   "status" : "SUCCESS"
}

getNames

החזרת כל שמות הסיומים.

נקודת קצה של API:https://api.tld-list.com/v1/extension/getNames

זמן תגובה:~1 second

פרמטרים של בקשה

מפתח סוג חובה תיאור
omitExtensionsWithoutRegistrars boolean כאשר true, הרחבות שאין להן נתוני תמחור רשם בתוצאות מושמטות. ברירת המחדל היא false.
wantPunycode boolean קידוד כל סיומות IDN שהוחזרו כ- punycode במקום unicode. ברירת המחדל היא false.

אובייקט תגובה

נתיב סוג תיאור
data array of strings מערך שמות סיומות.

בקשה/תגובה לדוגמה

curl -X POST https://api.tld-list.com/v1/extension/getNames -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "wantPunycode": true, "omitExtensionsWithoutRegistrars": true}'

{
   "data" : [
      "2000.hu",
      "5g.in",
      "6g.in",
      "aaa.pro",
      "abc.br",
      "abkhazia.su",
      "abo.pa",
      "abogado",
      "abr.it",
      "abruzzo.it",
      "abudhabi",
      ...
      "xn--3bst00m",
      "xn--jvr189m",
      "xn--imr513n",
      "xn--j6w193g",
      "xn--t60b56a",
      "xn--mk1bu44c",
      "xn--3e0b707e"
   ],
   "errors" : [],
   "seconds" : 0.697,
   "status" : "SUCCESS"
}

getCheapestRegistrar

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

נקודת קצה של API:https://api.tld-list.com/v1/extension/getCheapestRegistrar

זמן תגובה:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

פרמטרים של בקשה

מפתח סוג חובה תיאור
pricetypes array of strings

מציין את סוגי התמחור שיש לאחזר. אם הושמט, כל 3 סוגי המחירים (register, renewal, transfer) יוחזרו.

דוגמה: "pricetypes": ["register", "transfer"]
extensions array of strings

מציין אילו הרחבות יש לאחזר. אל תכלול נקודה קודמת. שמות הרחבות יכולים להיות unicode או המקבילה שלהם punycode. אם הושמט, כל ההרחבות המפורטות ב- TLD-List יוחזרו.

דוגמה: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]
includeRegistrars array of strings

מזהי המחרוזת של רשמים פעילים שיש לכלול בעת קביעת התמחור הזול ביותר והחישובים המצטברים. המערכת תתעלם מרשמים שלא צוינו בפרמטר זה. השתמש בשיטה getIds כדי לקבל רשימה של כל הרשמים הרשומים באופן פעיל ב- TLD-List.

אם פרמטר זה הושמט, כל הרשמים המפורטים באופן פעיל ב- TLD-List ייחשבו.

דוגמה: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]
excludeRegistrars array of strings

מזהי המחרוזת של רשמים פעילים כדי לא לכלול בעת קביעת התמחור הזול ביותר וחישובים מצטברים. כל הרשמים שלא צוינו בפרמטר זה ייחשבו. השתמש בשיטה getIds כדי לקבל רשימה של כל הרשמים הרשומים באופן פעיל ב- TLD-List.

אם פרמטר זה מושמט, לא יתעלמו מרשמים.

דוגמה: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]
omitExtensionsWithoutRegistrars boolean

כאשר true, הרחבות שאין להן נתוני תמחור של הרשם בתוצאות מושמטות. מצב זה מתרחש כאשר הפרמטרים שהועברו ו/או includeRegistrars גרמו להרחבה שבדרך excludeRegistrars כלל כוללת נתוני תמחור של הרשם להיות ללא נתוני תמחור תואמים של הרשם. הרחבות אלה כלולות כברירת מחדל, אך עם מערכים ריקים עבור נתוני התמחור שלהן. הגדר כדי true להשמיט הרחבות אלה מהתוצאות.

דוגמה: "omitExtensionsWithoutRegistrars": true

אובייקט תגובה

נתיב סוג תיאור
data array of objects מערך של אובייקטים, שכל אחד מהם מייצג סיומת תחום.
data[].name string שם Unicode של סיומת התחום.
data[].punycode string שם Punycode של סיומת התחום. קיים רק עבור הרחבות IDN.
data[].currency string קוד המטבע ISO 4217 בן שלוש האותיות של נתוני התמחור. ערך זה הוא כרגע רק USD.
data[].registrarsIncluded number ספירת הרשמים הכלולים בנתוני התמחור המוחזרים.
data[].average object אובייקט המכיל את המחיר הממוצע של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים.
data[].average[pricetype] string המחיר הממוצע של ההרחבה כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.
data[].median object אובייקט המכיל את המחיר החציוני של ההרחבה, לפי סוג מחיר, עבור הרשמים הכלולים.
data[].median[pricetype] string המחיר החציוני של ההרחבה כמחרוזת מספרית עבור [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.
data[].cheapest object אובייקט המכיל את הרשמים הזולים ביותר עבור ההרחבה לפי סוג מחיר.
data[].cheapest[pricetype] array of objects

מערך של אובייקטי RegistrarPricing המכילים את הרשמים הזולים ביותר לפי [pricetype], כאשר המפתח [pricetype] הוא register, renewal, transfer.

נתונים אלה הם מערך מכיוון שהמחיר הזול ביותר עבור ההרחבה יכול להיות אותו מחיר שמציע יותר מרשם אחד.

בקשה/תגובה לדוגמה

curl -X POST https://api.tld-list.com/v1/extension/getCheapestRegistrar -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "includeRegistrars": ["godaddy", "namecheap", "porkbun", "namesilo", "netim"], "extensions": ["com", "co.uk"]}'

{
   "data" : [
      {
         "average" : {
            "register" : "7.85",
            "renewal" : "10.25",
            "transfer" : "11.99"
         },
         "cheapest" : {
            "register" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "4.96",
                  "priceOriginal" : "5.96",
                  "prices" : {
                     "register" : "4.96",
                     "renewal" : "5.96"
                  },
                  "pricesOriginal" : {
                     "register" : "5.96"
                  },
                  "pricetype" : "register",
                  "promo" : {
                     "amount" : "1.00",
                     "code" : "AWESOMENESS",
                     "type" : "discount"
                  },
                  "promos" : [
                     {
                        "amount" : "1.00",
                        "code" : "AWESOMENESS",
                        "type" : "discount"
                     }
                  ],
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "18.36"
               }
            ],
            "renewal" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "5.96",
                  "prices" : {
                     "register" : "4.96",
                     "renewal" : "5.96"
                  },
                  "pricetype" : "renewal",
                  "threeYearValueScore" : "18.36"
               }
            ],
            "transfer" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     }
                  ],
                  "id" : "godaddy",
                  "name" : "GoDaddy",
                  "notes" : {
                     "feeTax" : [
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "~",
                           "amountRateType" : "percent-varies-by-location",
                           "appliesToCustomers" : [
                              "eu"
                           ],
                           "type" : "vat"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "15",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "in"
                           ],
                           "type" : "gst"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "10",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "au"
                           ],
                           "type" : "gst"
                        }
                     ]
                  },
                  "price" : "11.99",
                  "prices" : {
                     "register" : "6.49",
                     "renewal" : "11.99",
                     "transfer" : "11.99"
                  },
                  "pricetype" : "transfer",
                  "threeYearValueScore" : "3.46"
               }
            ]
         },
         "currency" : "USD",
         "median" : {
            "register" : "6.48",
            "renewal" : "10.78",
            "transfer" : "11.99"
         },
         "name" : "co.uk",
         "registrarsIncluded" : 4,
         "registrarsTotal" : 47
      },
      {
         "average" : {
            "register" : "8.90",
            "renewal" : "14.10",
            "transfer" : "9.30"
         },
         "cheapest" : {
            "register" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "whois-privacy"
                     }
                  ],
                  "id" : "godaddy",
                  "name" : "GoDaddy",
                  "notes" : {
                     "feeIcann" : {
                        "addedToListPrice" : true,
                        "amount" : "0.18"
                     },
                     "feeTax" : [
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "~",
                           "amountRateType" : "percent-varies-by-location",
                           "appliesToCustomers" : [
                              "eu"
                           ],
                           "type" : "vat"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "15",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "in"
                           ],
                           "type" : "gst"
                        },
                        {
                           "addedToListPrice" : false,
                           "amountRate" : "10",
                           "amountRateType" : "percent",
                           "appliesToCustomers" : [
                              "au"
                           ],
                           "type" : "gst"
                        }
                     ]
                  },
                  "price" : "3.17",
                  "priceOriginal" : "10.18",
                  "prices" : {
                     "register" : "3.17",
                     "renewal" : "20.17",
                     "transfer" : "8.17",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricesOriginal" : {
                     "register" : "10.18"
                  },
                  "pricetype" : "register",
                  "promo" : {
                     "amount" : "2.99",
                     "code" : "GDD2dom",
                     "start" : "2023-01-01T00:00:00",
                     "type" : "price"
                  },
                  "promos" : [
                     {
                        "amount" : "2.99",
                        "code" : "GDD2dom",
                        "start" : "2023-01-01T00:00:00",
                        "type" : "price"
                     }
                  ],
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "5.76"
               }
            ],
            "renewal" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "whois-privacy"
                     },
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "email-forward"
                     },
                     {
                        "name" : "ssl-cert"
                     }
                  ],
                  "id" : "porkbun",
                  "name" : "Porkbun",
                  "price" : "9.73",
                  "prices" : {
                     "register" : "8.73",
                     "renewal" : "9.73",
                     "transfer" : "9.73",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricetype" : "renewal",
                  "threeYearValueScore" : "16.03"
               }
            ],
            "transfer" : [
               {
                  "currency" : "USD",
                  "freeFeatures" : [
                     {
                        "name" : "dns"
                     },
                     {
                        "name" : "whois-privacy"
                     },
                     {
                        "name" : "email-forward"
                     }
                  ],
                  "id" : "namecheap",
                  "name" : "Namecheap",
                  "notes" : {
                     "feeIcann" : {
                        "addedToListPrice" : true,
                        "amount" : "0.18"
                     }
                  },
                  "price" : "7.16",
                  "prices" : {
                     "register" : "6.16",
                     "renewal" : "14.16",
                     "restore" : "13.98",
                     "transfer" : "7.16",
                     "whoisPrivacy" : "0.00"
                  },
                  "pricetype" : "transfer",
                  "terms" : {
                     "limitPerCustomer" : {
                        "count" : 1
                     }
                  },
                  "threeYearValueScore" : "10.15"
               }
            ]
         },
         "currency" : "USD",
         "median" : {
            "register" : "10.95",
            "renewal" : "10.95",
            "transfer" : "9.95"
         },
         "name" : "com",
         "registrarsIncluded" : 5,
         "registrarsTotal" : 59
      }
   ],
   "errors" : [],
   "seconds" : 0.126,
   "status" : "SUCCESS"
}

שיטות רשם

getIds

פונקציה זו מחזירה את כל מזהי הרשם, שכל אחד מהם מזהה באופן ייחודי רשם הרשום באופן פעיל ב- TLD-List.

נקודת קצה של API:https://api.tld-list.com/v1/registrar/getIds

זמן תגובה:< 1 second

פרמטרים של בקשה

ללא

אובייקט תגובה

נתיב סוג תיאור
data array of strings מערך של מזהי רשם מחרוזות.

בקשה/תגובה לדוגמה

curl -X POST https://api.tld-list.com/v1/registrar/getIds -H 'Content-Type: application/json' -d '{"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"}'

{
   "data" : [
      "101domain",
      "123reg",
      "above.com",
      ...
      "upflare",
      "webnames.ca"
   ],
   "errors" : [],
   "seconds" : 0.001,
   "status" : "SUCCESS"
}