📚 API v1.0 ΑΠΛΟ

ΤΕΚΜΗΡΙΩΣΗ API

Ενσωμάτωσε το Gender-API στην εφαρμογή σου με το απλό και ισχυρό RESTful API μας. Ξεκίνα μέσα σε λίγα λεπτά.

rocket_launch Απλή χρήση language Τοπικοποίηση group Πολλαπλά ονόματα email Διεύθυνση Email public Χώρα bar_chart Στατιστικά

Ενοποιημένο API (v2.0) ΠΡΟΧΩΡΗΜΕΝΟ

Αν είσαι προχωρημένος χρήστης με υψηλό όγκο αιτημάτων, μπορείς επίσης να μεταβείς στο νέο endpoint API V2.0 μας. Το ενοποιημένο API προσφέρει πολύ μεγαλύτερη ταχύτητα και μια πιο αξιόπιστη διεπαφή όταν κάνεις ερώτημα για πολλά ονόματα σε ένα μόνο αίτημα, αλλά είναι λίγο πιο πολύπλοκο στην υλοποίηση.

swap_horiz Προβολή ενοποιημένου API v2.0

🚀 Εργαλεία API

Εξερεύνησε το API μας χρησιμοποιώντας εργαλεία βιομηχανικού προτύπου

Προβολή Swagger Docs → Εισαγωγή στο Postman →

ΑΠΛΗ ΧΡΗΣΗ

Αυτός είναι ο πιο εύκολος τρόπος για να ζητήσεις προσδιορισμό φύλου. Κάθε απάντηση είναι κωδικοποιημένη σε JSON:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Απλή χρήση - αναζήτηση φύλου με όνομα
PURPOSE: Αυτός είναι ο πιο εύκολος τρόπος για να ζητήσεις προσδιορισμό φύλου. Κάθε απάντηση είναι κωδικοποιημένη σε JSON.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?name=Elizabeth&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"name":"diana","name_sanitized":"Diana","gender":"female","samples":523,"accuracy":93,"duration":"41ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέν όνομα με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?name=Elizabeth&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Μικρό όνομα

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=Elizabeth&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`key`	String	Το κλειδί API σου

check_circle Απάντηση

{"name":"diana","name_sanitized":"Diana","gender":"female","samples":523,"accuracy":93,"duration":"41ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέν όνομα με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΤΟΠΙΚΟΠΟΙΗΣΗ

Πρόσθεσε περισσότερη ακρίβεια στο αίτημά σου κάνοντας το ερώτημά σου πιο συγκεκριμένο γεωγραφικά:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Εντοπισμός - κωδικός χώρας (v1)
PURPOSE: Πρόσθεσε περισσότερη ακρίβεια στο αίτημά σου εντοπίζοντας την αναζήτηση με κωδικούς χωρών.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?name=Andrea&country=IT&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: country
  Type: String
  Required: OPTIONAL
  Description: Κωδικός χώρας ISO 3166 ALPHA-2

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
//In Italy, Andrea is male. 
{"name":"andrea","name_sanitized":"Andrea","country":"IT","gender":"male","samples":1068,"accuracy":95,"duration":"15ms","credits_used":1}

//In Germany, Andrea is female. 
{"name":"andrea","name_sanitized":"Andrea","country":"DE","gender":"female","samples":4089,"accuracy":85,"duration":"33ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέν όνομα με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: country
  Type: String
  Description: Υποβληθείς κωδικός χώρας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?name=Andrea&country=IT&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Παράδειγμα Ιταλίας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=Andrea&country=IT&key=<το κλειδί api σου>

send Αίτημα

Παράδειγμα Γερμανίας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=Andrea&country=DE&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`country`	String	Κωδικός χώρας ISO 3166 ALPHA-2
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Παράδειγμα Ιταλίας

//In Italy, Andrea is male. 
{"name":"andrea","name_sanitized":"Andrea","country":"IT","gender":"male","samples":1068,"accuracy":95,"duration":"15ms","credits_used":1}

check_circle Απάντηση

Παράδειγμα Γερμανίας

//In Germany, Andrea is female. 
{"name":"andrea","name_sanitized":"Andrea","country":"DE","gender":"female","samples":4089,"accuracy":85,"duration":"33ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέν όνομα με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`country`	String	Υποβληθείς κωδικός χώρας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Έγκυροι κωδικοί χωρών:

Andorra

United Arab Emirates

Afghanistan

Albania

Armenia

Angola

Argentina

Austria

Australia

Azerbaijan

Bosnia and Herzegovina

Barbados

Bangladesh

Belgium

Burkina Faso

Bulgaria

Bahrain

Burundi

Benin

Brunei

Bolivia

Brazil

Bahamas

Botswana

Belarus

Belize

Canada

Congo - Kinshasa

Congo - Brazzaville

Switzerland

Côte d’Ivoire

Chile

Cameroon

China

Colombia

Costa Rica

Cuba

Cape Verde

Cyprus

Czech Republic

Germany

Djibouti

Denmark

Dominican Republic

Algeria

Ecuador

Estonia

Egypt

Western Sahara

Spain

Ethiopia

Finland

Fiji

Micronesia

France

Gabon

United Kingdom

Georgia

French Guiana

Ghana

Gibraltar

Greenland

Gambia

Guinea

Guadeloupe

Equatorial Guinea

Greece

Guatemala

Guam

Guyana

Hong Kong SAR China

Honduras

Croatia

Haiti

Hungary

Indonesia

Ireland

Israel

India

Iraq

Iran

Iceland

Italy

Jersey

Jamaica

Jordan

Japan

Kenya

Kyrgyzstan

Cambodia

Comoros

South Korea

Kuwait

Kazakhstan

Laos

Lebanon

Saint Lucia

Liechtenstein

Sri Lanka

Liberia

Lesotho

Lithuania

Luxembourg

Latvia

Libya

Morocco

Monaco

Moldova

Montenegro

Madagascar

Macedonia

Mali

Myanmar [Burma]

Mongolia

Martinique

Mauritania

Malta

Mauritius

Maldives

Malawi

Mexico

Malaysia

Mozambique

Namibia

New Caledonia

Niger

Nigeria

Nicaragua

Netherlands

Norway

Nepal

New Zealand

Oman

Panama

Peru

French Polynesia

Papua New Guinea

Philippines

Pakistan

Poland

Puerto Rico

Palestinian Territories

Portugal

Paraguay

Qatar

Réunion

Romania

Serbia

Russia

Rwanda

Saudi Arabia

Seychelles

Sudan

Sweden

Singapore

Saint Helena

Slovenia

Slovakia

Sierra Leone

San Marino

Senegal

Somalia

Suriname

São Tomé and Príncipe

El Salvador

Syria

Swaziland

Chad

Togo

Thailand

Tajikistan

Timor-Leste

Turkmenistan

Tunisia

Turkey

Trinidad and Tobago

Taiwan

Tanzania

Ukraine

Uganda

United States

Uruguay

Uzbekistan

Venezuela

U.S. Virgin Islands

Vietnam

Yemen

Mayotte

South Africa

Zambia

Zimbabwe

ΤΟΠΙΚΟΠΟΙΗΣΗ - ΧΩΡΑ ΑΠΟ IP

Επίλεξε τη χώρα του πελάτη σου βάσει της διεύθυνσης IP τους:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Τοπικοποίηση - χώρα από IP (v1)
PURPOSE: Επίλεξε τη χώρα του πελάτη σου με βάση τη διεύθυνση IP του.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?name=john&ip=54.201.16.177&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: ip
  Type: String
  Required: OPTIONAL
  Description: Έγκυρη διεύθυνση IP

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":9991,"accuracy":99,"duration":"44ms","credits_used":1}

{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"508ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέν όνομα με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: country
  Type: String
  Description: Υποβληθείς κωδικός χώρας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?name=john&ip=54.201.16.177&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Παράδειγμα με διεύθυνση IP από τις ΗΠΑ

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=john&ip=54.201.16.177&key=<το κλειδί api σου>

send Αίτημα

Παράδειγμα με διεύθυνση IP από τη Γερμανία

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=tanja&ip=178.27.177.23&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`ip`	String	Έγκυρη διεύθυνση IP
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Παράδειγμα με διεύθυνση IP από τις ΗΠΑ

{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":9991,"accuracy":99,"duration":"44ms","credits_used":1}

check_circle Απάντηση

Παράδειγμα με διεύθυνση IP από τη Γερμανία

{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"508ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέν όνομα με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`country`	String	Υποβληθείς κωδικός χώρας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Το Gender-API.com περιλαμβάνει δεδομένα GeoLite2 που δημιουργήθηκαν από τη MaxMind, διαθέσιμα από http://www.maxmind.com.

ΤΟΠΙΚΟΠΟΙΗΣΗ - ΧΩΡΑ ΜΕ ΒΑΣΗ ΤΗ ΓΛΩΣΣΑ ΤΟΥ ΠΕΡΙΗΓΗΤΗ / ΠΕΡΙΟΧΗ

Επίλεξε τη χώρα του πελάτη σου με βάση τη γλώσσα του περιηγητή του:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Τοπικοποίηση - γλώσσα προγράμματος περιήγησης (v1)
PURPOSE: Επίλεξε τη χώρα του πελάτη σου με βάση τη γλώσσα του browser για αυτόματη τοπικοποίηση.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?name=john&locale=en_US&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: locale
  Type: String
  Required: OPTIONAL
  Description: Browser locale

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":991,"accuracy":99,"duration":"47ms","credits_used":1}

{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"99ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέν όνομα με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: country
  Type: String
  Description: Υποβληθείς κωδικός χώρας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?name=john&locale=en_US&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Παράδειγμα με τοπική ρύθμιση των ΗΠΑ

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=john&locale=en_US&key=<το κλειδί api σου>

send Αίτημα

Παράδειγμα με μια γερμανική τοποθεσία

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=tanja&locale=de_DE&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`locale`	String	Browser locale
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Παράδειγμα με τοπική ρύθμιση των ΗΠΑ

{"name":"john","name_sanitized":"John","country":"US","gender":"male","samples":991,"accuracy":99,"duration":"47ms","credits_used":1}

check_circle Απάντηση

Παράδειγμα με μια γερμανική τοποθεσία

{"name":"tanja","name_sanitized":"Tanja","country":"DE","gender":"female","samples":143,"accuracy":97,"duration":"99ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέν όνομα με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`country`	String	Υποβληθείς κωδικός χώρας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΕΡΩΤΗΣΗ ΓΙΑ ΠΟΛΛΑΠΛΑ ΟΝΟΜΑΤΑ

Μερικές φορές είναι απαραίτητο να ανακτούμε πολλαπλά ονόματα με μία ερώτηση:

info Απαιτούμενα αιτήματα: 1 πίστωση για κάθε όνομα

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Αναζήτηση πολλαπλών ονομάτων (v1)
PURPOSE: Ανάκτησε πολλά ονόματα με ένα αίτημα, χρησιμοποιώντας τιμές χωρισμένες με ερωτηματικό.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Διαχωρισμένη με ερωτηματικό λίστα ονομάτων για αναζήτηση

Parameter: country
  Type: String
  Required: OPTIONAL
  Description: Διαχωρισμένη με ερωτηματικό λίστα κωδικών χωρών. Οι κωδικοί χωρών πρέπει να είναι με την ίδια σειρά όπως και τα ονόματα. Αν δοθεί μόνο ένας κωδικός χώρας, αυτός ο κωδικός θα χρησιμοποιηθεί για όλα τα ονόματα.

Parameter: multi
  Type: Boolean (true|false)
  Required: REQUIRED (for this endpoint)
  Description: Εντολή προς το API να επιστρέψει το αποτέλεσμα ως πίνακα

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}

{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέντα ονόματα σε πεζά γράμματα. Ο μέγιστος αριθμός ονομάτων είναι περιορισμένος σε 100.

Field: result
  Type: Array
  Description: Δες την απάντηση κάτω από το "Simple Usage"

Field: country
  Type: String
  Description: Υποβλήθηκε λίστα με κωδικούς χωρών

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1 πίστωση για κάθε όνομα

=== END OF INSTRUCTIONS ===

send Αίτημα

Χωρίς κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=lisa;jess;thomas&multi=true&key=<το κλειδί api σου>

send Αίτημα

Με κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?name=anna;jack;stephen&country=DE;US;CA&multi=true&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Διαχωρισμένη με ερωτηματικό λίστα ονομάτων για αναζήτηση
`country`	String	Διαχωρισμένη με ερωτηματικό λίστα κωδικών χωρών. Οι κωδικοί χωρών πρέπει να είναι με την ίδια σειρά όπως και τα ονόματα. Αν δοθεί μόνο ένας κωδικός χώρας, αυτός ο κωδικός θα χρησιμοποιηθεί για όλα τα ονόματα.
`multi`	Boolean (true\|false)	Εντολή προς το API να επιστρέψει το αποτέλεσμα ως πίνακα
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Χωρίς κωδικό χώρας

{"name":"lisa;jess;thomas","result":[
{"name":"lisa","name_sanitized":"Lisa","country":"","gender":"female","samples":806,"accuracy":98},
{"name":"jess","name_sanitized":"Jess","country":"","gender":"female","samples":28,"accuracy":75},
{"name":"thomas","name_sanitized":"Thomas","country":"","gender":"male","samples":2239,"accuracy":99}],
"country":"","duration":"425ms","credits_used":3}

check_circle Απάντηση

Με κωδικό χώρας

{"name":"anna;jack;stephen","result":[
{"name":"anna","name_sanitized":"Anna","country":"DE","gender":"female","samples":1245,"accuracy":98},
{"name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90},
{"name":"stephen","name_sanitized":"Stephen","country":"CA","gender":"male","samples":77,"accuracy":82}],
"country":"DE;US;CA","duration":"668ms","credits_used":3}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέντα ονόματα σε πεζά γράμματα. Ο μέγιστος αριθμός ονομάτων είναι περιορισμένος σε 100.
`result`	Array	Δες την απάντηση κάτω από το "Simple Usage"
`country`	String	Υποβλήθηκε λίστα με κωδικούς χωρών
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΔΙΕΥΘΥΝΣΗ EMAIL

Μπορείς επίσης να αναζητήσεις ένα φύλο χρησιμοποιώντας μια διεύθυνση email που περιέχει ένα όνομα:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Αναζήτηση με διεύθυνση email (v1)
PURPOSE: Αναζήτησε φύλο χρησιμοποιώντας μια διεύθυνση email που περιέχει μικρό όνομα.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?email=markus.johnson@gmail.com&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: email
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Email address

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"email":"markus.johnson@gmail.com","last_name":"Johnson","first_name":"Markus","mail_provider":"gmail","name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"669ms","credits_used":1}

{"email":"jack.meyer@gmail.com","last_name":"Meyer","first_name":"Jack","mail_provider":"gmail","name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90,"duration":"1011ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: email
  Type: String
  Description: Η υποβληθείσα διεύθυνση email

Field: last_name
  Type: String
  Description: Το βρέθηκε επώνυμο

Field: first_name
  Type: String
  Description: Το βρέθηκε όνομα

Field: mail_provider
  Type: String
  Description: Όνομα του παρόχου email

Field: name
  Type: String
  Description: Το όνομα βρέθηκε με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: country
  Type: String
  Description: Υποβληθείς κωδικός χώρας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?email=markus.johnson@gmail.com&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Χωρίς κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?email=markus.johnson@gmail.com&key=<το κλειδί api σου>

send Αίτημα

Με κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?email=jack.meyer@gmail.com&country=US&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`email`	String	Email address
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Χωρίς κωδικό χώρας

{"email":"markus.johnson@gmail.com","last_name":"Johnson","first_name":"Markus","mail_provider":"gmail","name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"669ms","credits_used":1}

check_circle Απάντηση

Με κωδικό χώρας

{"email":"jack.meyer@gmail.com","last_name":"Meyer","first_name":"Jack","mail_provider":"gmail","name":"jack","name_sanitized":"Jack","country":"US","gender":"male","samples":667,"accuracy":90,"duration":"1011ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`email`	String	Η υποβληθείσα διεύθυνση email
`last_name`	String	Το βρέθηκε επώνυμο
`first_name`	String	Το βρέθηκε όνομα
`mail_provider`	String	Όνομα του παρόχου email
`name`	String	Το όνομα βρέθηκε με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`country`	String	Υποβληθείς κωδικός χώρας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

ΔΙΑΧΩΡΙΣΜΟΣ ΟΝΟΜΑΤΟΣ ΚΑΙ ΕΠΩΝΥΜΟΥ

Αν χρησιμοποιείς ένα συνδυασμένο πεδίο για το όνομα και το επώνυμο στη σελίδα σου, χρησιμοποίησε αυτό το API για να εξαγάγεις τα μέρη:

info Απαιτούμενα αιτήματα: 1

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Διαχωρισμός μικρού και επώνυμου (v1)
PURPOSE: Εξήγαγε τα μέρη μικρού και επώνυμου από ένα συνδυασμένο πεδίο και προσδιόρισε το φύλο.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get?split=theresa%20miller&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: split
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Πλήρες όνομα

Parameter: country
  Type: String
  Required: OPTIONAL
  Description: Κωδικός χώρας ISO 3166 ALPHA-2

Parameter: strict
  Type: Boolean (true|false)
  Required: OPTIONAL
  Description: Όταν η αυστηρή λειτουργία είναι ενεργοποιημένη, θα επιστρέψουμε null στο πεδίο last_name αν το last_name δεν μπορεί να βρεθεί στη βάση δεδομένων μας. Όταν η αυστηρή λειτουργία είναι απενεργοποιημένη, θα προσπαθήσουμε να εξάγουμε το επώνυμο ακόμα κι αν δεν μπορεί να βρεθεί στη βάση δεδομένων μας

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}

{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}

{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}

--- RESPONSE FIELDS ---

Field: last_name
  Type: String
  Description: Το βρέθηκε επώνυμο

Field: first_name
  Type: String
  Description: Το βρέθηκε όνομα

Field: strict
  Type: Boolean
  Description: Αληθές αν η αυστηρή λειτουργία είναι ενεργοποιημένη

Field: name
  Type: String
  Description: Το όνομα βρέθηκε με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: country
  Type: String
  Description: Υποβληθείς κωδικός χώρας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get?split=theresa%20miller&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 1

=== END OF INSTRUCTIONS ===

send Αίτημα

Χωρίς κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?split=theresa%20miller&key=<το κλειδί api σου>

send Αίτημα

Με κωδικό χώρας

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<το κλειδί api σου>

send Αίτημα

Αυστηρή λειτουργία ενεργοποιημένη

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`split`	String	Πλήρες όνομα
`country`	String	Κωδικός χώρας ISO 3166 ALPHA-2
`strict`	Boolean (true\|false)	Όταν η αυστηρή λειτουργία είναι ενεργοποιημένη, θα επιστρέψουμε null στο πεδίο last_name αν το last_name δεν μπορεί να βρεθεί στη βάση δεδομένων μας. Όταν η αυστηρή λειτουργία είναι απενεργοποιημένη, θα προσπαθήσουμε να εξάγουμε το επώνυμο ακόμα κι αν δεν μπορεί να βρεθεί στη βάση δεδομένων μας
`key`	String	Το κλειδί API σου

check_circle Απάντηση

Χωρίς κωδικό χώρας

{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}

check_circle Απάντηση

Με κωδικό χώρας

{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}

check_circle Απάντηση

Αυστηρή λειτουργία ενεργοποιημένη

{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`last_name`	String	Το βρέθηκε επώνυμο
`first_name`	String	Το βρέθηκε όνομα
`strict`	Boolean	Αληθές αν η αυστηρή λειτουργία είναι ενεργοποιημένη
`name`	String	Το όνομα βρέθηκε με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`country`	String	Υποβληθείς κωδικός χώρας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Παρακαλώ υπόδειξε στους πελάτες σου να εισάγουν τα ονόματά τους με τη μορφή "Όνομα, Επώνυμο", που κάνει την απάντησή μας πιο ακριβή.

GET STATS

Με αυτή την κλήση μπορείς να τραβήξεις κάποια στατιστικά για τον λογαριασμό σου:

info Απαιτούμενα αιτήματα: 0 αιτήματα

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Λήψη Στατιστικών (v1)
PURPOSE: Πάρε στατιστικά για τον λογαριασμό σου, όπως τα υπόλοιπα αιτήματα και τη χρήση.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get-stats?&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{"key":"yourkey","is_limit_reached":false,"remaining_requests":43566,"amount_month_start":90000,"amount_month_bought":100000,"duration":"37ms"}

--- RESPONSE FIELDS ---

Field: key
  Type: String
  Description: Το κλειδί API σου

Field: is_limit_reached
  Type: Boolean
  Description: Επιστρέφει true αν δεν υπάρχουν άλλα διαθέσιμα αιτήματα

Field: remaining_requests
  Type: Integer
  Description: Μετράει τα υπόλοιπα αιτήματα

Field: amount_month_start
  Type: Integer
  Description: Αιτήματα που απομένουν στην αρχή του μήνα

Field: amount_month_bought
  Type: Integer
  Description: Αιτήματα που αγοράστηκαν αυτόν τον μήνα

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get-stats?&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 0 αιτήματα

=== END OF INSTRUCTIONS ===

send Αίτημα

GET https://gender-api.com/get-stats?&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`key`	String	Το κλειδί API σου

check_circle Απάντηση

{"key":"yourkey","is_limit_reached":false,"remaining_requests":43566,"amount_month_start":90000,"amount_month_bought":100000,"duration":"37ms"}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`key`	String	Το κλειδί API σου
`is_limit_reached`	Boolean	Επιστρέφει true αν δεν υπάρχουν άλλα διαθέσιμα αιτήματα
`remaining_requests`	Integer	Μετράει τα υπόλοιπα αιτήματα
`amount_month_start`	Integer	Αιτήματα που απομένουν στην αρχή του μήνα
`amount_month_bought`	Integer	Αιτήματα που αγοράστηκαν αυτόν τον μήνα
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Λάβε τη χώρα προέλευσης

Λάβε τη χώρα προέλευσης ενός ονόματος:

info Απαιτούμενα αιτήματα: 2

smart_toy Οδηγίες υλοποίησης AI

=== AI IMPLEMENTATION INSTRUCTIONS ===

ENDPOINT: Εύρεση χώρας προέλευσης (v1)
PURPOSE: Βρες τη χώρα προέλευσης ενός μικρού ονόματος με πιθανότητες.

--- API DETAILS ---
Method: GET
URL: https://gender-api.com/get-country-of-origin?name=Markus&key=YOUR_API_KEY

--- AUTHENTICATION ---

--- REQUEST PARAMETERS ---

Parameter: name
  Type: String
  Required: REQUIRED (for this endpoint)
  Description: Όνομα για αναζήτηση

Parameter: key
  Type: String
  Required: REQUIRED
  Description: Το κλειδί API σου

--- EXPECTED RESPONSE ---

Response (JSON):
{
    "name": "markus",
    "country_of_origin": [
        {
            "countryName": "Finland",
            "country": "FI",
            "probability": 0.74,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Sweden",
            "country": "SE",
            "probability": 0.22,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Other",
            "country": "--",
            "probability": 0.04
        }
    ],
    "name_sanitized": "Markus",
    "gender": "male",
    "samples": 150,
    "accuracy": 99,
    "country_of_origin_map_url": "https://gender-api.com/en/map/37/3da90b0fe64e5102"
    "credits_used": 2,
    "duration": "165ms"
}

--- RESPONSE FIELDS ---

Field: name
  Type: String
  Description: Υποβληθέν όνομα με πεζά γράμματα

Field: name_sanitized
  Type: String
  Description: Το όνομα μετά την εφαρμογή του κανονικοποιητή μας

Field: gender
  Type: String
  Description: Πιθανές τιμές: male, female, unknown

Field: samples
  Type: Integer
  Description: Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου

Field: accuracy
  Type: Integer
  Description: Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή

Field: country_of_origin
  Type: Array
  Description: Οι 25 κορυφαίες χώρες προέλευσης. Δες την «%sΠλήρη λίστα πιθανών χωρών%s» για μια λίστα με τις υποστηριζόμενες χώρες

Field: country_of_origin_map_url
  Type: String
  Description: Ένας σύνδεσμος προς έναν χάρτη που εμφανίζει το αποτέλεσμα σε αποδομένη μορφή. Ο χάρτης μπορεί να προσπελαστεί για 10 λεπτά.
Για παράδειγμα, μπορείς να ενσωματώσεις αυτόν τον χάρτη στο προϊόν σου χρησιμοποιώντας ένα iframe.

Field: duration
  Type: String
  Description: Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα

Field: credits_used
  Type: Integer
  Description: Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

--- IMPLEMENTATION NOTES ---

1. Make sure to replace placeholder values:
   - Replace '' with your actual API key
   - Replace domain placeholders with the actual API domain

2. Handle errors appropriately:
   - Check HTTP status codes
   - Parse error responses
   - Implement retry logic for transient failures

3. Best Practices:
   - Store API keys securely (use environment variables)
   - Implement rate limiting on your side
   - Cache responses when appropriate
   - Use HTTPS for all requests
   - Set appropriate timeout values

4. RECOMMENDED: Implement the Statistics Endpoint
   - The statistics endpoint allows users to monitor their credit usage
   - Users can see how many credits they have used and how many are left
   - This helps prevent unexpected service interruptions
   - API v1: GET /get-stats?key=YOUR_API_KEY
   - API v2: GET /v2/statistic (with Authorization Bearer token)
   - Display remaining credits in your application's UI
   - Consider adding alerts when credits are running low

--- IMPLEMENTATION TEMPLATE ---

// Example implementation in cURL:
curl -X GET \
  'https://gender-api.com/get-country-of-origin?name=Markus&key=YOUR_API_KEY' \

--- CREDIT USAGE ---
Required Requests: 2

=== END OF INSTRUCTIONS ===

send Αίτημα

Μικρό όνομα

play_arrow Δοκίμασε ζωντανά με το codepen.io

GET https://gender-api.com/get-country-of-origin?name=Markus&key=<το κλειδί api σου>

list Παράμετροι αιτήματος

Πεδίο	Τύπος	Περιγραφή
`name`	String	Όνομα για αναζήτηση
`key`	String	Το κλειδί API σου

check_circle Απάντηση

{
    "name": "markus",
    "country_of_origin": [
        {
            "countryName": "Finland",
            "country": "FI",
            "probability": 0.74,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Sweden",
            "country": "SE",
            "probability": 0.22,
            "continentalRegion": "Europe",
            "statisticalRegion": "Northern Europe"
        },
        {
            "countryName": "Other",
            "country": "--",
            "probability": 0.04
        }
    ],
    "name_sanitized": "Markus",
    "gender": "male",
    "samples": 150,
    "accuracy": 99,
    "country_of_origin_map_url": "https://gender-api.com/en/map/37/3da90b0fe64e5102"
    "credits_used": 2,
    "duration": "165ms"
}

list Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`name`	String	Υποβληθέν όνομα με πεζά γράμματα
`name_sanitized`	String	Το όνομα μετά την εφαρμογή του κανονικοποιητή μας
`gender`	String	Πιθανές τιμές: male, female, unknown
`samples`	Integer	Αριθμός εγγραφών που βρέθηκαν στη βάση δεδομένων μας και ταιριάζουν με το αίτημά σου
`accuracy`	Integer	Αυτή η τιμή καθορίζει την αξιοπιστία της βάσης δεδομένων μας. Μία τιμή 100 σημαίνει ότι τα αποτελέσματα του αιτήματός σου για το φύλο είναι 100% ακριβή
`country_of_origin`	Array	Οι 25 κορυφαίες χώρες προέλευσης. Δες την «%sΠλήρη λίστα πιθανών χωρών%s» για μια λίστα με τις υποστηριζόμενες χώρες
`country_of_origin_map_url`	String	Ένας σύνδεσμος προς έναν χάρτη που εμφανίζει το αποτέλεσμα σε αποδομένη μορφή. Ο χάρτης μπορεί να προσπελαστεί για 10 λεπτά. Για παράδειγμα, μπορείς να ενσωματώσεις αυτόν τον χάρτη στο προϊόν σου χρησιμοποιώντας ένα iframe.
`duration`	String	Χρόνος που χρειάστηκε ο διακομιστής για να επεξεργαστεί το αίτημα
`credits_used`	Integer	Η ποσότητα αιτημάτων που χρησιμοποιήθηκαν για αυτό το ερώτημα

Στιγμιότυπο διαδραστικού χάρτη

Πλήρης λίστα πιθανών χωρών

            
                Κωδικός χώρας
                Όνομα χώρας
                Στατιστική περιοχή
                Ηπειρωτική περιοχή
            

                    CN
                    China
                    Eastern Asia
                    Asia
                

                    IN
                    India
                    Southern Asia
                    Asia
                

                    US
                    United States
                    Northern America
                    Americas
                

                    ID
                    Indonesia
                    South-eastern Asia
                    Asia
                

                    BR
                    Brazil
                    South America
                    Americas
                

                    PK
                    Pakistan
                    Southern Asia
                    Asia
                

                    NG
                    Nigeria
                    Western Africa
                    Africa
                

                    BD
                    Bangladesh
                    Southern Asia
                    Asia
                

                    RU
                    Russia
                    Eastern Europe
                    Europe
                

                    MX
                    Mexico
                    Central America
                    Americas
                

                    JP
                    Japan
                    Eastern Asia
                    Asia
                

                    ET
                    Ethiopia
                    Eastern Africa
                    Africa
                

                    PH
                    Philippines
                    South-eastern Asia
                    Asia
                

                    EG
                    Egypt
                    Northern Africa
                    Africa
                

                    VN
                    Vietnam
                    South-eastern Asia
                    Asia
                

                    DE
                    Germany
                    Western Europe
                    Europe
                

                    CD
                    Democratic Republic of the Congo
                    Middle Africa
                    Africa
                

                    IR
                    Iran
                    Southern Asia
                    Asia
                

                    TR
                    Turkey
                    Western Asia
                    Asia
                

                    TH
                    Thailand
                    South-eastern Asia
                    Asia
                

                    GB
                    United Kingdom
                    Northern Europe
                    Europe
                

                    FR
                    France
                    Western Europe
                    Europe
                

                    IT
                    Italy
                    Southern Europe
                    Europe
                

                    TZ
                    Tanzania
                    Eastern Africa
                    Africa
                

                    ZA
                    South Africa
                    Southern Africa
                    Africa
                

                    MM
                    Myanmar
                    South-eastern Asia
                    Asia
                

                    KR
                    South Korea
                    Eastern Asia
                    Asia
                

                    CO
                    Colombia
                    South America
                    Americas
                

                    KE
                    Kenya
                    Eastern Africa
                    Africa
                

                    ES
                    Spain
                    Southern Europe
                    Europe
                

                    AR
                    Argentina
                    South America
                    Americas
                

                    UA
                    Ukraine
                    Eastern Europe
                    Europe
                

                    UG
                    Uganda
                    Eastern Africa
                    Africa
                

                    DZ
                    Algeria
                    Northern Africa
                    Africa
                

                    SD
                    Sudan
                    Northern Africa
                    Africa
                

                    IQ
                    Iraq
                    Western Asia
                    Asia
                

                    PL
                    Poland
                    Eastern Europe
                    Europe
                

                    CA
                    Canada
                    Northern America
                    Americas
                

                    MA
                    Morocco
                    Northern Africa
                    Africa
                

                    AF
                    Afghanistan
                    Southern Asia
                    Asia
                

                    SA
                    Saudi Arabia
                    Western Asia
                    Asia
                

                    PE
                    Peru
                    South America
                    Americas
                

                    VE
                    Venezuela
                    South America
                    Americas
                

                    UZ
                    Uzbekistan
                    Central Asia
                    Asia
                

                    MY
                    Malaysia
                    South-eastern Asia
                    Asia
                

                    AO
                    Angola
                    Middle Africa
                    Africa
                

                    MZ
                    Mozambique
                    Eastern Africa
                    Africa
                

                    NP
                    Nepal
                    Southern Asia
                    Asia
                

                    GH
                    Ghana
                    Western Africa
                    Africa
                

                    YE
                    Yemen
                    Western Asia
                    Asia
                

                    MG
                    Madagascar
                    Eastern Africa
                    Africa
                

                    KP
                    North Korea
                    Eastern Asia
                    Asia
                

                    AU
                    Australia
                    AustraliaandNew Zealand
                    Oceania
                

                    CI
                    Ivory Coast
                    Western Africa
                    Africa
                

                    CM
                    Cameroon
                    Middle Africa
                    Africa
                

                    TW
                    Taiwan
                    Eastern Asia
                    Asia
                

                    NE
                    Niger
                    Western Africa
                    Africa
                

                    LK
                    Sri Lanka
                    Southern Asia
                    Asia
                

                    RO
                    Romania
                    Eastern Europe
                    Europe
                

                    BF
                    Burkina Faso
                    Western Africa
                    Africa
                

                    MW
                    Malawi
                    Eastern Africa
                    Africa
                

                    ML
                    Mali
                    Western Africa
                    Africa
                

                    SY
                    Syria
                    Western Asia
                    Asia
                

                    KZ
                    Kazakhstan
                    Central Asia
                    Asia
                

                    CL
                    Chile
                    South America
                    Americas
                

                    ZM
                    Zambia
                    Eastern Africa
                    Africa
                

                    NL
                    Netherlands
                    Western Europe
                    Europe
                

                    GT
                    Guatemala
                    Central America
                    Americas
                

                    EC
                    Ecuador
                    South America
                    Americas
                

                    ZW
                    Zimbabwe
                    Eastern Africa
                    Africa
                

                    KH
                    Cambodia
                    South-eastern Asia
                    Asia
                

                    SN
                    Senegal
                    Western Africa
                    Africa
                

                    TD
                    Chad
                    Middle Africa
                    Africa
                

                    SO
                    Somalia
                    Eastern Africa
                    Africa
                

                    GN
                    Guinea
                    Western Africa
                    Africa
                

                    SD
                    Sudan
                    Northern Africa
                    Africa
                

                    RW
                    Rwanda
                    Eastern Africa
                    Africa
                

                    TN
                    Tunisia
                    Northern Africa
                    Africa
                

                    CU
                    Cuba
                    Caribbean
                    Americas
                

                    BE
                    Belgium
                    Western Europe
                    Europe
                

                    BJ
                    Benin
                    Western Africa
                    Africa
                

                    GR
                    Greece
                    Southern Europe
                    Europe
                

                    BO
                    Bolivia
                    South America
                    Americas
                

                    HT
                    Haiti
                    Caribbean
                    Americas
                

                    BI
                    Burundi
                    Eastern Africa
                    Africa
                

                    DO
                    Dominican Republic
                    Caribbean
                    Americas
                

                    CZ
                    Czech Republic
                    Eastern Europe
                    Europe
                

                    PT
                    Portugal
                    Southern Europe
                    Europe
                

                    SE
                    Sweden
                    Northern Europe
                    Europe
                

                    AZ
                    Azerbaijan
                    Western Asia
                    Asia
                

                    HU
                    Hungary
                    Eastern Europe
                    Europe
                

                    JO
                    Jordan
                    Western Asia
                    Asia
                

                    BY
                    Belarus
                    Eastern Europe
                    Europe
                

                    AE
                    United Arab Emirates
                    Western Asia
                    Asia
                

                    HN
                    Honduras
                    Central America
                    Americas
                

                    TJ
                    Tajikistan
                    Central Asia
                    Asia
                

                    RS
                    Serbia
                    Southern Europe
                    Europe
                

                    AT
                    Austria
                    Western Europe
                    Europe
                

                    CH
                    Switzerland
                    Western Europe
                    Europe
                

                    IL
                    Israel
                    Western Asia
                    Asia
                

                    PG
                    Papua New Guinea
                    Melanesia
                    Oceania
                

                    TG
                    Togo
                    Western Africa
                    Africa
                

                    SL
                    Sierra Leone
                    Western Africa
                    Africa
                

                    HK
                    Hong Kong
                    Eastern Asia
                    Asia
                

                    BG
                    Bulgaria
                    Eastern Europe
                    Europe
                

                    LA
                    Laos
                    South-eastern Asia
                    Asia
                

                    PY
                    Paraguay
                    South America
                    Americas
                

                    SV
                    El Salvador
                    Central America
                    Americas
                

                    LY
                    Libya
                    Northern Africa
                    Africa
                

                    NI
                    Nicaragua
                    Central America
                    Americas
                

                    LB
                    Lebanon
                    Western Asia
                    Asia
                

                    KG
                    Kyrgyzstan
                    Central Asia
                    Asia
                

                    TM
                    Turkmenistan
                    Central Asia
                    Asia
                

                    DK
                    Denmark
                    Northern Europe
                    Europe
                

                    SG
                    Singapore
                    South-eastern Asia
                    Asia
                

                    FI
                    Finland
                    Northern Europe
                    Europe
                

                    SK
                    Slovakia
                    Eastern Europe
                    Europe
                

                    NO
                    Norway
                    Northern Europe
                    Europe
                

                    CG
                    Congo
                    Middle Africa
                    Africa
                

                    ER
                    Eritrea
                    Eastern Africa
                    Africa
                

                    PS
                    Palestine
                    Western Asia
                    Asia
                

                    CR
                    Costa Rica
                    Central America
                    Americas
                

                    IE
                    Ireland
                    Northern Europe
                    Europe
                

                    LR
                    Liberia
                    Western Africa
                    Africa
                

                    NZ
                    New Zealand
                    AustraliaandNew Zealand
                    Oceania
                

                    CF
                    Central African Republic
                    Middle Africa
                    Africa
                

                    OM
                    Oman
                    Western Asia
                    Asia
                

                    MR
                    Mauritania
                    Western Africa
                    Africa
                

                    HR
                    Croatia
                    Southern Europe
                    Europe
                

                    KW
                    Kuwait
                    Western Asia
                    Asia
                

                    PA
                    Panama
                    Central America
                    Americas
                

                    MD
                    Moldova
                    Eastern Europe
                    Europe
                

                    GE
                    Georgia
                    Western Asia
                    Asia
                

                    PR
                    Puerto Rico
                    Caribbean
                    Americas
                

                    BA
                    Bosnia and Herzegovina
                    Southern Europe
                    Europe
                

                    UY
                    Uruguay
                    South America
                    Americas
                

                    MN
                    Mongolia
                    Eastern Asia
                    Asia
                

                    AM
                    Armenia
                    Western Asia
                    Asia
                

                    AL
                    Albania
                    Southern Europe
                    Europe
                

                    JM
                    Jamaica
                    Caribbean
                    Americas
                

                    LT
                    Lithuania
                    Northern Europe
                    Europe
                

                    QA
                    Qatar
                    Western Asia
                    Asia
                

                    NA
                    Namibia
                    Southern Africa
                    Africa
                

                    BW
                    Botswana
                    Southern Africa
                    Africa
                

                    LS
                    Lesotho
                    Southern Africa
                    Africa
                

                    GM
                    The Gambia
                    Western Africa
                    Africa
                

                    MK
                    Republic of Macedonia
                    Southern Europe
                    Europe
                

                    SI
                    Slovenia
                    Southern Europe
                    Europe
                

                    GA
                    Gabon
                    Middle Africa
                    Africa
                

                    LV
                    Latvia
                    Northern Europe
                    Europe
                

                    GW
                    Guinea-Bissau
                    Western Africa
                    Africa
                

                    BH
                    Bahrain
                    Western Asia
                    Asia
                

                    TT
                    Trinidad and Tobago
                    Caribbean
                    Americas
                

                    SZ
                    Swaziland
                    Southern Africa
                    Africa
                

                    EE
                    Estonia
                    Northern Europe
                    Europe
                

                    TL
                    East Timor
                    South-eastern Asia
                    Asia
                

                    GQ
                    Equatorial Guinea
                    Middle Africa
                    Africa
                

                    MU
                    Mauritius
                    Eastern Africa
                    Africa
                

                    CY
                    Cyprus
                    Western Asia
                    Asia
                

                    DJ
                    Djibouti
                    Eastern Africa
                    Africa
                

                    FJ
                    Fiji
                    Melanesia
                    Oceania
                

                    RE
                    Réunion
                    Eastern Africa
                    Africa
                

                    KM
                    Comoros
                    Eastern Africa
                    Africa
                

                    BT
                    Bhutan
                    Southern Asia
                    Asia
                

                    GY
                    Guyana
                    South America
                    Americas
                

                    ME
                    Montenegro
                    Southern Europe
                    Europe
                

                    MO
                    Macau
                    Eastern Asia
                    Asia
                

                    SB
                    Solomon Islands
                    Melanesia
                    Oceania
                

                    LU
                    Luxembourg
                    Western Europe
                    Europe
                

                    SR
                    Suriname
                    South America
                    Americas
                

                    EH
                    Western Sahara
                    Northern Africa
                    Africa
                

                    CV
                    Cape Verde
                    Western Africa
                    Africa
                

                    GP
                    Guadeloupe
                    Caribbean
                    Americas
                

                    MV
                    Maldives
                    Southern Asia
                    Asia
                

                    MT
                    Malta
                    Southern Europe
                    Europe
                

                    BN
                    Brunei
                    South-eastern Asia
                    Asia
                

                    BS
                    Bahamas
                    Caribbean
                    Americas
                

                    MQ
                    Martinique
                    Caribbean
                    Americas
                

                    BZ
                    Belize
                    Central America
                    Americas
                

                    IS
                    Iceland
                    Northern Europe
                    Europe
                

                    BB
                    Barbados
                    Caribbean
                    Americas
                

                    PF
                    French Polynesia
                    Polynesia
                    Oceania
                

                    GF
                    French Guiana
                    South America
                    Americas
                

                    NC
                    New Caledonia
                    Melanesia
                    Oceania
                

                    VU
                    Vanuatu
                    Melanesia
                    Oceania
                

                    YT
                    Mayotte
                    Eastern Africa
                    Africa
                

                    ST
                    Sao Tome and Principe
                    Middle Africa
                    Africa
                

                    WS
                    Samoa
                    Polynesia
                    Oceania
                

                    LC
                    Saint Lucia
                    Caribbean
                    Americas
                

                    JE
                    Guernsey and Jersey
                    Northern Europe
                    Europe
                

                    GU
                    Guam
                    Micronesia
                    Oceania
                

                    CW
                    Curaçao
                    Caribbean
                    Americas
                

                    KI
                    Kiribati
                    Micronesia
                    Oceania
                

                    VC
                    Saint Vincent and the Grenadines
                    Caribbean
                    Americas
                

                    TO
                    Tonga
                    Polynesia
                    Oceania
                

                    GD
                    Grenada
                    Caribbean
                    Americas
                

                    FM
                    Federated States of Micronesia
                    Micronesia
                    Oceania
                

                    AW
                    Aruba
                    Caribbean
                    Americas
                

                    VI
                    United States Virgin Islands
                    Caribbean
                    Americas
                

                    AG
                    Antigua and Barbuda
                    Caribbean
                    Americas
                

                    SC
                    Seychelles
                    Eastern Africa
                    Africa
                

                    IM
                    Isle of Man
                    Northern Europe
                    Europe
                

                    AD
                    Andorra
                    Southern Europe
                    Europe
                

                    DM
                    Dominica
                    Caribbean
                    Americas
                

                    KY
                    Cayman Islands
                    Caribbean
                    Americas
                

                    BM
                    Bermuda
                    Northern America
                    Americas
                

                    GL
                    Greenland
                    Northern America
                    Americas
                

                    AS
                    American Samoa
                    Polynesia
                    Oceania
                

                    KN
                    Saint Kitts and Nevis
                    Caribbean
                    Americas
                

                    MP
                    Northern Mariana Islands
                    Micronesia
                    Oceania
                

                    MH
                    Marshall Islands
                    Micronesia
                    Oceania
                

                    FO
                    Faroe Islands
                    Northern Europe
                    Europe
                

                    SX
                    Sint Maarten
                    Caribbean
                    Americas
                

                    MC
                    Monaco
                    Western Europe
                    Europe
                

                    LI
                    Liechtenstein
                    Western Europe
                    Europe
                

                    TC
                    Turks and Caicos Islands
                    Caribbean
                    Americas
                

                    GI
                    Gibraltar
                    Southern Europe
                    Europe
                

                    SM
                    San Marino
                    Southern Europe
                    Europe
                

                    VG
                    British Virgin Islands
                    Caribbean
                    Americas
                

                    BQ
                    Caribbean Netherlands
                    Caribbean
                    Americas
                

                    PW
                    Palau
                    Micronesia
                    Oceania
                

                    CK
                    Cook Islands
                    Polynesia
                    Oceania
                

                    AI
                    Anguilla
                    Caribbean
                    Americas
                

                    WF
                    Wallis and Futuna
                    Polynesia
                    Oceania
                

                    NR
                    Nauru
                    Micronesia
                    Oceania
                

                    TV
                    Tuvalu
                    Polynesia
                    Oceania
                

                    PM
                    Saint Pierre and Miquelon
                    Northern America
                    Americas
                

                    MS
                    Montserrat
                    Caribbean
                    Americas
                

                    SH
                    Saint Helena Ascension and Tristan da Cunha
                    Western Africa
                    Africa
                

                    FK
                    Falkland Islands
                    South America
                    Americas
                

                    NU
                    Niue
                    Polynesia
                    Oceania
                

                    TK
                    Tokelau
                    Polynesia
                    Oceania
                

                    VA
                    Vatican City
                    Southern Europe
                    Europe
                

ΚΩΔΙΚΟΙ ΣΦΑΛΜΑΤΩΝ

            check_circle
            Απάντηση          Error Example Message
{"errno":30,"errmsg":"limit reached"}
          
                              errno (Αριθμός Σφάλματος)
                              errmsg (Μήνυμα Σφάλματος)
                              Περιγραφή
                          
                                      10
                                      invalid country code
                                      Δες "Έγκυροι κωδικοί χωρών"
                                
                                      11
                                      number of country codes not equal to number of names
                                      Η καταμέτρηση ονομάτων δεν ταιριάζει με την καταμέτρηση των κωδικών χωρών
                                
                                      20
                                      name not set
                                      Δεν λήφθηκε όνομα από τον διακομιστή
                                
                                      21
                                      too many names
                                      Επιτρέπονται μόνο 100 ονόματα ταυτόχρονα
                                
                                      30
                                      limit reached
                                      Έχεις φτάσει το όριο αναζητήσεων
                                
                                      40
                                      invalid or missing key
                                      Το κλειδί του διακομιστή σου δεν βρέθηκε στη βάση δεδομένων μας
                                
                                      500
                                      unknown error
                                      Εσωτερικό σφάλμα διακομιστή

Κωδικός χώρας	Όνομα χώρας	Στατιστική περιοχή	Ηπειρωτική περιοχή
CN	China	Eastern Asia	Asia
IN	India	Southern Asia	Asia
US	United States	Northern America	Americas
ID	Indonesia	South-eastern Asia	Asia
BR	Brazil	South America	Americas
PK	Pakistan	Southern Asia	Asia
NG	Nigeria	Western Africa	Africa
BD	Bangladesh	Southern Asia	Asia
RU	Russia	Eastern Europe	Europe
MX	Mexico	Central America	Americas
JP	Japan	Eastern Asia	Asia
ET	Ethiopia	Eastern Africa	Africa
PH	Philippines	South-eastern Asia	Asia
EG	Egypt	Northern Africa	Africa
VN	Vietnam	South-eastern Asia	Asia
DE	Germany	Western Europe	Europe
CD	Democratic Republic of the Congo	Middle Africa	Africa
IR	Iran	Southern Asia	Asia
TR	Turkey	Western Asia	Asia
TH	Thailand	South-eastern Asia	Asia
GB	United Kingdom	Northern Europe	Europe
FR	France	Western Europe	Europe
IT	Italy	Southern Europe	Europe
TZ	Tanzania	Eastern Africa	Africa
ZA	South Africa	Southern Africa	Africa
MM	Myanmar	South-eastern Asia	Asia
KR	South Korea	Eastern Asia	Asia
CO	Colombia	South America	Americas
KE	Kenya	Eastern Africa	Africa
ES	Spain	Southern Europe	Europe
AR	Argentina	South America	Americas
UA	Ukraine	Eastern Europe	Europe
UG	Uganda	Eastern Africa	Africa
DZ	Algeria	Northern Africa	Africa
SD	Sudan	Northern Africa	Africa
IQ	Iraq	Western Asia	Asia
PL	Poland	Eastern Europe	Europe
CA	Canada	Northern America	Americas
MA	Morocco	Northern Africa	Africa
AF	Afghanistan	Southern Asia	Asia
SA	Saudi Arabia	Western Asia	Asia
PE	Peru	South America	Americas
VE	Venezuela	South America	Americas
UZ	Uzbekistan	Central Asia	Asia
MY	Malaysia	South-eastern Asia	Asia
AO	Angola	Middle Africa	Africa
MZ	Mozambique	Eastern Africa	Africa
NP	Nepal	Southern Asia	Asia
GH	Ghana	Western Africa	Africa
YE	Yemen	Western Asia	Asia
MG	Madagascar	Eastern Africa	Africa
KP	North Korea	Eastern Asia	Asia
AU	Australia	AustraliaandNew Zealand	Oceania
CI	Ivory Coast	Western Africa	Africa
CM	Cameroon	Middle Africa	Africa
TW	Taiwan	Eastern Asia	Asia
NE	Niger	Western Africa	Africa
LK	Sri Lanka	Southern Asia	Asia
RO	Romania	Eastern Europe	Europe
BF	Burkina Faso	Western Africa	Africa
MW	Malawi	Eastern Africa	Africa
ML	Mali	Western Africa	Africa
SY	Syria	Western Asia	Asia
KZ	Kazakhstan	Central Asia	Asia
CL	Chile	South America	Americas
ZM	Zambia	Eastern Africa	Africa
NL	Netherlands	Western Europe	Europe
GT	Guatemala	Central America	Americas
EC	Ecuador	South America	Americas
ZW	Zimbabwe	Eastern Africa	Africa
KH	Cambodia	South-eastern Asia	Asia
SN	Senegal	Western Africa	Africa
TD	Chad	Middle Africa	Africa
SO	Somalia	Eastern Africa	Africa
GN	Guinea	Western Africa	Africa
SD	Sudan	Northern Africa	Africa
RW	Rwanda	Eastern Africa	Africa
TN	Tunisia	Northern Africa	Africa
CU	Cuba	Caribbean	Americas
BE	Belgium	Western Europe	Europe
BJ	Benin	Western Africa	Africa
GR	Greece	Southern Europe	Europe
BO	Bolivia	South America	Americas
HT	Haiti	Caribbean	Americas
BI	Burundi	Eastern Africa	Africa
DO	Dominican Republic	Caribbean	Americas
CZ	Czech Republic	Eastern Europe	Europe
PT	Portugal	Southern Europe	Europe
SE	Sweden	Northern Europe	Europe
AZ	Azerbaijan	Western Asia	Asia
HU	Hungary	Eastern Europe	Europe
JO	Jordan	Western Asia	Asia
BY	Belarus	Eastern Europe	Europe
AE	United Arab Emirates	Western Asia	Asia
HN	Honduras	Central America	Americas
TJ	Tajikistan	Central Asia	Asia
RS	Serbia	Southern Europe	Europe
AT	Austria	Western Europe	Europe
CH	Switzerland	Western Europe	Europe
IL	Israel	Western Asia	Asia
PG	Papua New Guinea	Melanesia	Oceania
TG	Togo	Western Africa	Africa
SL	Sierra Leone	Western Africa	Africa
HK	Hong Kong	Eastern Asia	Asia
BG	Bulgaria	Eastern Europe	Europe
LA	Laos	South-eastern Asia	Asia
PY	Paraguay	South America	Americas
SV	El Salvador	Central America	Americas
LY	Libya	Northern Africa	Africa
NI	Nicaragua	Central America	Americas
LB	Lebanon	Western Asia	Asia
KG	Kyrgyzstan	Central Asia	Asia
TM	Turkmenistan	Central Asia	Asia
DK	Denmark	Northern Europe	Europe
SG	Singapore	South-eastern Asia	Asia
FI	Finland	Northern Europe	Europe
SK	Slovakia	Eastern Europe	Europe
NO	Norway	Northern Europe	Europe
CG	Congo	Middle Africa	Africa
ER	Eritrea	Eastern Africa	Africa
PS	Palestine	Western Asia	Asia
CR	Costa Rica	Central America	Americas
IE	Ireland	Northern Europe	Europe
LR	Liberia	Western Africa	Africa
NZ	New Zealand	AustraliaandNew Zealand	Oceania
CF	Central African Republic	Middle Africa	Africa
OM	Oman	Western Asia	Asia
MR	Mauritania	Western Africa	Africa
HR	Croatia	Southern Europe	Europe
KW	Kuwait	Western Asia	Asia
PA	Panama	Central America	Americas
MD	Moldova	Eastern Europe	Europe
GE	Georgia	Western Asia	Asia
PR	Puerto Rico	Caribbean	Americas
BA	Bosnia and Herzegovina	Southern Europe	Europe
UY	Uruguay	South America	Americas
MN	Mongolia	Eastern Asia	Asia
AM	Armenia	Western Asia	Asia
AL	Albania	Southern Europe	Europe
JM	Jamaica	Caribbean	Americas
LT	Lithuania	Northern Europe	Europe
QA	Qatar	Western Asia	Asia
NA	Namibia	Southern Africa	Africa
BW	Botswana	Southern Africa	Africa
LS	Lesotho	Southern Africa	Africa
GM	The Gambia	Western Africa	Africa
MK	Republic of Macedonia	Southern Europe	Europe
SI	Slovenia	Southern Europe	Europe
GA	Gabon	Middle Africa	Africa
LV	Latvia	Northern Europe	Europe
GW	Guinea-Bissau	Western Africa	Africa
BH	Bahrain	Western Asia	Asia
TT	Trinidad and Tobago	Caribbean	Americas
SZ	Swaziland	Southern Africa	Africa
EE	Estonia	Northern Europe	Europe
TL	East Timor	South-eastern Asia	Asia
GQ	Equatorial Guinea	Middle Africa	Africa
MU	Mauritius	Eastern Africa	Africa
CY	Cyprus	Western Asia	Asia
DJ	Djibouti	Eastern Africa	Africa
FJ	Fiji	Melanesia	Oceania
RE	Réunion	Eastern Africa	Africa
KM	Comoros	Eastern Africa	Africa
BT	Bhutan	Southern Asia	Asia
GY	Guyana	South America	Americas
ME	Montenegro	Southern Europe	Europe
MO	Macau	Eastern Asia	Asia
SB	Solomon Islands	Melanesia	Oceania
LU	Luxembourg	Western Europe	Europe
SR	Suriname	South America	Americas
EH	Western Sahara	Northern Africa	Africa
CV	Cape Verde	Western Africa	Africa
GP	Guadeloupe	Caribbean	Americas
MV	Maldives	Southern Asia	Asia
MT	Malta	Southern Europe	Europe
BN	Brunei	South-eastern Asia	Asia
BS	Bahamas	Caribbean	Americas
MQ	Martinique	Caribbean	Americas
BZ	Belize	Central America	Americas
IS	Iceland	Northern Europe	Europe
BB	Barbados	Caribbean	Americas
PF	French Polynesia	Polynesia	Oceania
GF	French Guiana	South America	Americas
NC	New Caledonia	Melanesia	Oceania
VU	Vanuatu	Melanesia	Oceania
YT	Mayotte	Eastern Africa	Africa
ST	Sao Tome and Principe	Middle Africa	Africa
WS	Samoa	Polynesia	Oceania
LC	Saint Lucia	Caribbean	Americas
JE	Guernsey and Jersey	Northern Europe	Europe
GU	Guam	Micronesia	Oceania
CW	Curaçao	Caribbean	Americas
KI	Kiribati	Micronesia	Oceania
VC	Saint Vincent and the Grenadines	Caribbean	Americas
TO	Tonga	Polynesia	Oceania
GD	Grenada	Caribbean	Americas
FM	Federated States of Micronesia	Micronesia	Oceania
AW	Aruba	Caribbean	Americas
VI	United States Virgin Islands	Caribbean	Americas
AG	Antigua and Barbuda	Caribbean	Americas
SC	Seychelles	Eastern Africa	Africa
IM	Isle of Man	Northern Europe	Europe
AD	Andorra	Southern Europe	Europe
DM	Dominica	Caribbean	Americas
KY	Cayman Islands	Caribbean	Americas
BM	Bermuda	Northern America	Americas
GL	Greenland	Northern America	Americas
AS	American Samoa	Polynesia	Oceania
KN	Saint Kitts and Nevis	Caribbean	Americas
MP	Northern Mariana Islands	Micronesia	Oceania
MH	Marshall Islands	Micronesia	Oceania
FO	Faroe Islands	Northern Europe	Europe
SX	Sint Maarten	Caribbean	Americas
MC	Monaco	Western Europe	Europe
LI	Liechtenstein	Western Europe	Europe
TC	Turks and Caicos Islands	Caribbean	Americas
GI	Gibraltar	Southern Europe	Europe
SM	San Marino	Southern Europe	Europe
VG	British Virgin Islands	Caribbean	Americas
BQ	Caribbean Netherlands	Caribbean	Americas
PW	Palau	Micronesia	Oceania
CK	Cook Islands	Polynesia	Oceania
AI	Anguilla	Caribbean	Americas
WF	Wallis and Futuna	Polynesia	Oceania
NR	Nauru	Micronesia	Oceania
TV	Tuvalu	Polynesia	Oceania
PM	Saint Pierre and Miquelon	Northern America	Americas
MS	Montserrat	Caribbean	Americas
SH	Saint Helena Ascension and Tristan da Cunha	Western Africa	Africa
FK	Falkland Islands	South America	Americas
NU	Niue	Polynesia	Oceania
TK	Tokelau	Polynesia	Oceania
VA	Vatican City	Southern Europe	Europe

errno (Αριθμός Σφάλματος)	errmsg (Μήνυμα Σφάλματος)	Περιγραφή
10	invalid country code	Δες "Έγκυροι κωδικοί χωρών"
11	number of country codes not equal to number of names	Η καταμέτρηση ονομάτων δεν ταιριάζει με την καταμέτρηση των κωδικών χωρών
20	name not set	Δεν λήφθηκε όνομα από τον διακομιστή
21	too many names	Επιτρέπονται μόνο 100 ονόματα ταυτόχρονα
30	limit reached	Έχεις φτάσει το όριο αναζητήσεων
40	invalid or missing key	Το κλειδί του διακομιστή σου δεν βρέθηκε στη βάση δεδομένων μας
500	unknown error	Εσωτερικό σφάλμα διακομιστή