​
Endpoints

The API endpoints reflect the nature of the GWI data offering. We run one of the world’s largest market research studies on the digital consumer, offering our clients a unique data set that enables strong strategic marketing and selling. All the endpoints are listed in the API reference. To query an endpoint, the request structure is always the same - you just change the path between the API root and the resource identifier to request the data you are interested in.

​
Rate limiting

Our system exposes a public API where requests made by clients can cause heavy load on our backend services. A rate limiting proxy is necessary to avoid DoS by API clients overloading our system by accident.

​
HTTP headers

  • Retry-After - Try again after N seconds
  • X-RateLimit-Limit - Total number of requests allowed within this time window
  • X-RateLimit-Remaining - The number of requests left for the time window
  • X-RateLimit-Reset - The remaining window before the rate limit resets in UTC epoch seconds

​
Responses and Status Codes

Responses will be in JSON format, and will be served along with appropriate HTTP response codes. For example, 200 will indicate a generic success, 201 the creation of a new resource, 204 the successful deletion of a resource, 400 a malformed request, 401 for missing or broken authorization, 403 for inaccessible data, 404 a request for data that is not available, etc. For more details refer to List of HTTP Status Codes.