Skip to main content
  • EN
Solved

Is There a Usage Limit for the Geonames Postal Code API?

  • September 19, 2024
  • 3 replies
  • 110 views
  • Translate
G

Hi,

I'm using the following API from Opendatasoft to access postal code data:

API Endpoint: https://data.opendatasoft.com/api/explore/v2.1/catalog/datasets/geonames-postal-code@public/records

I would like to know if there are any usage limits (rate limits, request quotas, etc.) associated with this API. Specifically:

  1. Are there any daily or hourly rate limits?
  2. Is there a limit to the number of records returned per request?
  3. Do I need to worry about throttling if I exceed a certain threshold of requests?

Thank you for your help!

Auto-translation đŸȘ„

Bonjour,J'utilise l'API suivante d'Opendatasoft pour accĂ©der aux donnĂ©es de codes postaux :Point de terminaison de l'API : https://data.opendatasoft.com/api/explore/v2.1/catalog/datasets/geonames-postal-code@public/recordsJe voudrais savoir s'il existe des limites d'utilisation (limites de dĂ©bit, quotas de requĂȘtes, etc.) associĂ©es Ă  cette API. Plus prĂ©cisĂ©ment :Existe-t-il des limites de dĂ©bit journaliĂšres ou horaires ? Existe-t-il une limite au nombre d'enregistrements renvoyĂ©s par requĂȘte ? Dois-je m'inquiĂ©ter de la limitation si je dĂ©passe un certain seuil de requĂȘtes ?Merci pour votre aide !

Best answer by yier.wu

Hi 

If you are registered on data hub portal, you can check directly your API rate limit (daily) on the portal interface. !-->

Here is a useful article : https://userguide.opendatasoft.com/l/en/article/sqvj2ayh6o

!-->

As for the limit on number of records, it depends on which endpoint you are using.

The API endpoint you used in your request is records. Its purpose is to quickly display the results of an API request on a dataset. For performance reasons, this endpoint is limited to displaying 100 records, and up to 10,000 with an offset (if the request does not contain a "group_by").

https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/getRecords

If you want to retrieve more than 100 records, I recommend using the export endpoint. Choose the data format in which you wish to export (json, csv, etc.). The limit is set by default with "limit=-1", which means that all records will be retrieved.

https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/exportRecords

Here is a learning path on Explore API on our Academy : https://academy.opendatasoft.com/reusing-data-with-explore-api

Kind regards,

Auto-translation đŸȘ„

Bonjour Si vous ĂȘtes inscrit sur le portail Data Hub, vous pouvez vĂ©rifier directement votre limite de dĂ©bit d'API (quotidienne) sur l'interface du portail.  !-->Voici un article utile : https://userguide.opendatasoft.com/l/en/article/sqvj2ayh6o!-->Quant Ă  la limite du nombre d'enregistrements, cela dĂ©pend du point de terminaison que vous utilisez.Le point de terminaison d'API que vous avez utilisĂ© dans votre requĂȘte est records. Son but est d'afficher rapidement les rĂ©sultats d'une requĂȘte d'API sur un jeu de donnĂ©es. Pour des raisons de performances, ce point de terminaison est limitĂ© Ă  l'affichage de 100 enregistrements, et jusqu'Ă  10 000 avec un dĂ©calage (si la requĂȘte ne contient pas de "group_by").https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/getRecordsSi vous souhaitez rĂ©cupĂ©rer plus de 100 enregistrements, je vous recommande d'utiliser le point de terminaison d'exportation. Choisissez le format de donnĂ©es dans lequel vous souhaitez exporter (json, csv, etc.). La limite est fixĂ©e par dĂ©faut avec « limit=-1 », ce qui signifie que tous les enregistrements seront
View original

    Y
    Community Manager
    • yier.wu
    • Community Manager
    • September 19, 2024

    Hi 

    If you are registered on data hub portal, you can check directly your API rate limit (daily) on the portal interface. !-->

    Here is a useful article : https://userguide.opendatasoft.com/l/en/article/sqvj2ayh6o

    !-->

    As for the limit on number of records, it depends on which endpoint you are using.

    The API endpoint you used in your request is records. Its purpose is to quickly display the results of an API request on a dataset. For performance reasons, this endpoint is limited to displaying 100 records, and up to 10,000 with an offset (if the request does not contain a "group_by").

    https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/getRecords

    If you want to retrieve more than 100 records, I recommend using the export endpoint. Choose the data format in which you wish to export (json, csv, etc.). The limit is set by default with "limit=-1", which means that all records will be retrieved.

    https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/exportRecords

    Here is a learning path on Explore API on our Academy : https://academy.opendatasoft.com/reusing-data-with-explore-api

    Kind regards,

    Auto-translation đŸȘ„

    Bonjour Si vous ĂȘtes inscrit sur le portail Data Hub, vous pouvez vĂ©rifier directement votre limite de dĂ©bit d'API (quotidienne) sur l'interface du portail.  !-->Voici un article utile : https://userguide.opendatasoft.com/l/en/article/sqvj2ayh6o!-->Quant Ă  la limite du nombre d'enregistrements, cela dĂ©pend du point de terminaison que vous utilisez.Le point de terminaison d'API que vous avez utilisĂ© dans votre requĂȘte est records. Son but est d'afficher rapidement les rĂ©sultats d'une requĂȘte d'API sur un jeu de donnĂ©es. Pour des raisons de performances, ce point de terminaison est limitĂ© Ă  l'affichage de 100 enregistrements, et jusqu'Ă  10 000 avec un dĂ©calage (si la requĂȘte ne contient pas de "group_by").https://help.opendatasoft.com/apis/ods-explore-v2/#tag/Dataset/operation/getRecordsSi vous souhaitez rĂ©cupĂ©rer plus de 100 enregistrements, je vous recommande d'utiliser le point de terminaison d'exportation. Choisissez le format de donnĂ©es dans lequel vous souhaitez exporter (json, csv, etc.). La limite est fixĂ©e par dĂ©faut avec « limit=-1 », ce qui signifie que tous les enregistrements seront
    Translate
    G

    https://data.opendatasoft.com/api/explore/v2.1/catalog/datasets/geonames-postal-code@public/records
    1)For using this api is there daily api call limit? 
    2)Do i need to use any api keys for this public api?

    Auto-translation đŸȘ„

    https://data.opendatasoft.com/api/explore/v2.1/catalog/datasets/geonames-postal-code@public/records1)Pour utiliser cette API, existe-t-il une limite d'appels d'API quotidiens ? 2)Dois-je utiliser des clĂ©s d'API pour cette API publique ?
    Translate
    Y
    Community Manager
    • yier.wu
    • Community Manager
    • September 20, 2024

    Hi,

    The daily API call limit depends on the user's quota, so you will need to check this information in your own account.

    When the data is public (as in this case), you do not need an API key.

    Regards,

    Auto-translation đŸȘ„

    Bonjour,La limite d'appels API quotidiens dépend du quota de l'utilisateur, vous devrez donc vérifier ces informations dans votre propre compte.Lorsque les données sont publiques (comme dans ce cas), vous n'avez pas besoin d'une clé API.Cordialement,
    Translate

    Reply


    Terms & ConditionsCookie settings

    Cookie policy

    We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

     
    Cookie settings
    Opendatasoft Terms & Conditions Cookie settings