Glossary of Technical Terms

This glossary defines technical terms and concepts used throughout the WinningHunter documentation.

Authentication & Security#

API Key#

A unique string used to identify and authenticate your requests to the WinningHunter API. Treat it like a password.

Bearer Token#

A security token that grants access to the owner of the token. In WinningHunter, your API key is used as a Bearer token in the Authorization header.

Regeneration#

The process of creating a new API key and invalidating the old one. This is essential if your key is leaked or compromised.

Networking & Performance#

Endpoint#

A specific URL where an API can be accessed (e.g., /api/v1/tiktok-shop/products/explore).

HTTP Status Codes#

Standardized three-digit numbers returned by a server to indicate the outcome of a request (e.g., 200 Tamam, 401 Yetkisiz, 429 Too Many Requests).

Rate Limiting#

A restriction on the number of requests a user can make within a specific timeframe (e.g., 60 requests per minute) to prevent abuse and ensure server stability.

Rolling Window#

A method of rate limiting where the time period is not fixed (like "per calendar minute") but is instead calculated relative to the current time (e.g., "the last 60 seconds from this exact moment").

Exponential Backoff#

A strategy where a client progressively increases the wait time between retries after receiving an error (e.g., waiting 1s, then 2s, then 4s).

Jitter#

Adding a small amount of random delay to an exponential backoff strategy to prevent multiple clients from retrying at the exact same moment.

Data & Pagination#

JSON (JavaScript Object Notation)#

A lightweight data-interchange format that is easy for humans to read and write and easy for machines to parse and generate.

Payload#

The actual data sent in the body of an HTTP request (usually in JSON format).

Pagination#

The process of dividing a large dataset into smaller, manageable "pages" of results.

Cursor (Keyset Pagination)#

A pointer used to navigate through large datasets efficiently. Instead of using page numbers, the client provides a cursor from the previous response to retrieve the next set of results.

Schema#

The formal definition of the structure and data types of a JSON object or database record.

WinningHunter Specifics#

Credits#

The monthly quota of requests allowed on your plan. Each successful metered API call consumes one credit.

API access#

The product entitlement that allows programmatic HTTP and MCP calls with an API key.

MCP (Model Context Protocol)#

An open standard that allows AI models (like Claude or ChatGPT) to securely access and use WinningHunter tools directly within their interface.