​

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.