Instant Gaming API

Instant Gaming API — Detailed Documentation

Click here to search page

Overview

Purpose: Query Instant Gaming using only a query string, optionally enriching with Latin America prices.
Framework: Flask · Entry: app.py · Templates: templates/ · Static: static/ · Logic: reqs.py
Language: English headers (Accept-Language: en-US,en;q=0.9).

Routes

GET / — Home with embedded docs.
GET /search — UI to search games.
GET /health — Health check.

API Endpoint

GET /api/search?query=QUERY

query (required): game name (e.g., elden ring).
latam_priority (optional): 1 default enrich, 0 skip for speed.
max_details (optional, int): enriched items count (default 6).
concurrency (optional, int): worker threads (default 6).
Legacy: /api/search/<game> redirects to the query variant.
IG URL (no filters): https://www.instant-gaming.com/pt/pesquisar/?query=QUERY

Response


[
	{
		"link": "https://www.instant-gaming.com/pt/awdadwadwd",
		"origin": "Instant Gaming",
		"price": "R$ 25,67",
		"title": awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdadwadwad",
		"origin": "Instant Gaming",
		"price": "R$ 158,47",
		"title": "awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdadwad",
		"origin": "Instant Gaming",
		"price": "R$ 11,03",
		"title": "awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdawdawda",
		"origin": "Instant Gaming",
		"price": "R$ 20,50",
		"title": "awd"
	}
]

Empty results: []. Missing query returns {"error":"Missing 'query' parameter"} with HTTP 400.

Examples

Performance & Behavior

Reuses connections with requests.Session.
Optional LATAM enrichment via concurrent product page requests.
Timeouts: 20s search, 12s products.
Filters (platform/type/gametype) are disabled for now.
Currency may vary depending on deployment locale.

Project Structure

app.py — routes
reqs.py — search/enrichment
templates/ — index.html, search.html
static/ — assets

Run Locally (Windows)

git clone https://github.com/diogolourencodev/latamgaming.git
cd latamgaming
python -m venv .venv
.\\.venv\\Scripts\\Activate.ps1
pip install -r requirements.txt
python app.py
# open http://127.0.0.1:5000

Deploy (Vercel)

Connect GitHub, import repo; Vercel detects Flask.
Set root if needed and deploy; test the endpoint.

Roadmap

Reintroduce filters (platform/type/gametype).
Add POST /api/search with JSON body.
Cache, pagination, currency normalization.
Bilingual filter-ready /search UI.

Instant Gaming API — Documentação Detalhada

Click here to search page

Visão Geral

Propósito: Consultar Instant Gaming usando apenas a string de pesquisa, opcionalmente enriquecendo com preços da América Latina.
Framework: Flask · Entrada: app.py · Templates: templates/ · Estático: static/ · Lógica: reqs.py
Idioma: Cabeçalhos em inglês (Accept-Language: en-US,en;q=0.9).

Rotas

GET / — Início com docs incorporadas.
GET /search — UI para buscar jogos.
GET /health — Verificação de saúde.

Endpoint da API

GET /api/search?query=QUERY

query (obrigatório): nome do jogo (ex.: elden ring).
latam_priority (opcional): 1 padrão enriquece, 0 para velocidade.
max_details (opcional, int): quantidade de itens enriquecidos (padrão 6).
concurrency (opcional, int): número de threads (padrão 6).
Legada: /api/search/<game> redireciona para a variante com query.
URL do IG (sem filtros): https://www.instant-gaming.com/pt/pesquisar/?query=QUERY

Resposta


[
	{
		"link": "https://www.instant-gaming.com/pt/awdadwadwd",
		"origin": "Instant Gaming",
		"price": "R$ 25,67",
		"title": awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdadwadwad",
		"origin": "Instant Gaming",
		"price": "R$ 158,47",
		"title": "awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdadwad",
		"origin": "Instant Gaming",
		"price": "R$ 11,03",
		"title": "awd"
	},
	{
		"link": "https://www.instant-gaming.com/pt/awdawdawda",
		"origin": "Instant Gaming",
		"price": "R$ 20,50",
		"title": "awd"
	}
]

Resultados vazios: []. Falta de query retorna {"error":"Missing 'query' parameter"} com HTTP 400.

Exemplos

Desempenho & Comportamento

Reutiliza conexões com requests.Session.
Enriquecimento LATAM opcional via requisições concorrentes.
Timeouts: 20s busca, 12s produtos.
Filtros (platform/type/gametype) desativados por enquanto.
Moeda pode variar conforme a localidade do deploy.

Estrutura do Projeto

app.py — rotas
reqs.py — busca/enriquecimento
templates/ — index.html, search.html
static/ — assets

Executar Localmente (Windows)

git clone https://github.com/diogolourencodev/latamgaming.git
cd latamgaming
python -m venv .venv
.\\.venv\\Scripts\\Activate.ps1
pip install -r requirements.txt
python app.py
# abrir http://127.0.0.1:5000

Deploy (Vercel)

Conecte o GitHub, importe o repo; Vercel detecta Flask.
Defina o root se necessário e faça o deploy; teste o endpoint.

Roadmap

Reintroduzir filtros (platform/type/gametype).
Adicionar POST /api/search com corpo JSON.
Cache, paginação, normalização de moeda.
UI de /search bilíngue com filtros.

Health route: /health · Search UI: /search