> ## Documentation Index
> Fetch the complete documentation index at: https://api.globalwebindex.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes).