Q: How do I get my API key?
A: You need to make sure you have a paying Placer account, and then you can contact your customer success manager to add permissions to your account and provide you with the access api-key.
Q: When is my weekly quota being renewed?
A: The quota renewal is scheduled for Sundays at 12:00 a.m. UTC.
Q: What are flagged venues? Are those venues participating in the visits counting or ranking process?
A: There are several reasons why a POI is being flagged (for example, lack of foot traffic information, dense area, etc.). This causes unreliable visits data, which Placer prefers not to consider.
Flagged venues will be returned when searching POIs or entities of a POI, but reports cannot be generated for the foot traffic of those entities.
Q: What are the defined API call rate limitations?
A: Please refer to the following throttle rate limits :
- The quota for reports preparation is - 5000/hour(relevant for reports endpoints);
- The quota for POI query/creation/deletion - 360/min or 10000/hour (relevant for all endpoints included in the manage POIs section);
- The quota for ranking reports- 8000/min or 80000/hour (relevant for ranking reports endpoints)
- General limitation - Execute up to 10 API calls/sec and up to 5 concurrent processes(Relevant for all endpoints)
Q: What API calls count towards my quota??
A: All API calls are counted towards your quota, except those that result in the following status codes:
- 202 (Accepted): The request has been accepted for processing but is not yet completed.
- 429 (Too Many Requests): The request was rejected due to rate limiting.
- 500 (Internal Server Error): The request failed due to a server-side error.
These excluded calls do not consume quota as they do not contribute to actual resource usage. All other API requests, including those that result in other client errors, are counted towards your quota