Logo

API Documentation

Logo

Frequently asked questions

If you can't find the answer for your problem here, please don't hesitate to contact to our technical support:

[email protected].

If you have any questions concerning about prices etc. contact sales team

Q1. How to make token or permanent api key?

You can create new token or api key at My API account

or create token with terminal command for example with 2 hours expiration:

curl -d '{ user: "<user>","password": "<password>" }' 'https://pfa.foreca.com/authorize/token?expire_hours=2'

More information about token generation can be found under documentation's Authorization part.

Q2. How to make API request?

Look at example queries for point forecasts and map API from our documenation's example page.

Q3. How to find out which API's I have?

You can find out which API products and features are activated from your My API account. You get access details for your API account within your sign up email.

Q4. Are there limitations for the token's lifetime?

This depends on what kind of token you have created: self-expiring or non-expiring. More information about token generation, lifetime etc can be found here.

Q5. Are there limitations for queries?

This depends on which API packages you have in use. Information about the different packages can be found here. Trial has limitation for 1000 requests for Map API + 1000 requests for Weather point Forecast API for a day.

Q6. How do I find out how many requests/API hits I have made?

You can monitor your API usage through My API account. From my API account you can also see the amount of your API hits and which API products and features are activated. You get access details for your API account within your sign up email.

Q7. How API hits/queries are counted?

Each API request to a specific end-point is counted as one query. Map API usage is measured by the number of tiles served —each tile counts as one request. Look at example queries for point forecasts and map API from our documenation's example page.

Q8. I have a problem of signing in my API account?

You get access details for your API account within your sign up email. Notice to use your administrative password, not API password.

Q9. Map API has precipitation forecasts with precipitation type. What does this precipitation type include?

Precipitation types include rain, sleet and snow.

Q10. Where to find symbols?

You'll find symbols and their mapping from Resources page. You can use your own symbols or download our custom symbol set free of charge from the link provided at the MyAPI page. Please note that the use of our weather symbols is reserved for customers actively utilizing our API. These symbols can only be used in conjunction with Foreca’s API data and not independently of this service.

Q11. Where to find Foreca's logo for attribution?

You can download Foreca's logo here.

Q12. Where to find information about prices of API packages?

You can find a list of available API package here.

Contact sales team for further information.

Q13. What is the resolution of your weather forecast?

Different parameters have different resolutions and they vary based on location and timescale. If there are observation stations nearby, they are used to improve forecast and forecast may vary even if moving just a kilometer. Some places we augment with higher resolution local models. Please contact our tech to get more information about the resolution of certain weather parameters for specific time and place.

Q14. For which height are parameters e.g. temperature calculated in your forecast?
  • Temperature: 2m
  • Relative humidity: 2m
  • Wind (all): 10m

Height of the parameters is above ground. Ground is assumed to be at the average elevation of the surrounding area.

Q15. Is it possible to add an icon for hail in the symbol set??

The symbol for hail has been under consideration, but we do not currently provide it, as it complicates user interfaces. We continue work on predicting hail more accurately and plan on including it in our symbol set in the future.