Rules of our API

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.