{"source":"NeBlask · affpapa.org","license":"CC BY 4.0","docs":"https://affpapa.org/neblask/api","openapi":"3.1.0","info":{"title":"NeBlask Open API","version":"1.0.0","summary":"Open iGaming demand dataset (share of search), licenses, games, providers, ground truth.","description":"Public read-only API. No authentication, CORS enabled for any origin, rate limit 120 req/min per IP. Data license: CC BY 4.0 (attribute affpapa.org/neblask). Docs for humans and agents: https://affpapa.org/neblask/api","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"url":"https://affpapa.org"}},"servers":[{"url":"https://affpapa.org/api/neblask/v1"}],"paths":{"/":{"get":{"operationId":"discovery","summary":"Dataset discovery document","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/openapi.json":{"get":{"operationId":"openapi","summary":"This specification","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/brands":{"get":{"operationId":"listBrands","summary":"List brands","parameters":[{"name":"status","in":"query","schema":{"type":"string"},"description":"exact brand status, e.g. active"},{"name":"has_license","in":"query","schema":{"type":"boolean"},"description":"only brands with at least one license"},{"name":"country","in":"query","schema":{"type":"string","pattern":"^[a-z]{2}$"},"description":"only brands with demand data in this market (ISO 3166-1 alpha-2, lowercase)"},{"name":"q","in":"query","schema":{"type":"string"},"description":"case-insensitive search in name and slug"},{"name":"sort","in":"query","schema":{"type":"string","enum":["slug","name","licenses_count"]}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"items per page (alias: limit)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"alias for per_page, convenient for AI agents"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/BrandListItem"}}}}}}}}}},"/brands/{slug}":{"get":{"operationId":"getBrand","summary":"Full brand card","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/BrandCard"}}}}}},"404":{"description":"Brand not found"}}}},"/licenses":{"get":{"operationId":"listLicenses","summary":"List licenses","parameters":[{"name":"regulator_code","in":"query","schema":{"type":"string"},"description":"e.g. ukgc, mga, dga"},{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"},"description":"brand slug"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"items per page (alias: limit)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"alias for per_page, convenient for AI agents"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/License"}}}}}}}}}},"/regulators":{"get":{"operationId":"listRegulators","summary":"Regulator directory with license counts","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Regulator"}}}}}}}}}},"/providers":{"get":{"operationId":"listProviders","summary":"Game providers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}}}}}}}}},"/games":{"get":{"operationId":"listGames","summary":"Game catalog","parameters":[{"name":"provider","in":"query","schema":{"type":"string"},"description":"provider slug"},{"name":"kind","in":"query","schema":{"type":"string"},"description":"e.g. slot"},{"name":"q","in":"query","schema":{"type":"string"},"description":"search in game name"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"items per page (alias: limit)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"alias for per_page, convenient for AI agents"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Game"}}}}}}}}}},"/countries":{"get":{"operationId":"listCountries","summary":"Markets and demand-data coverage","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Country"}}}}}}}}}},"/index":{"get":{"operationId":"listIndexValues","summary":"Demand index values","parameters":[{"name":"country","in":"query","schema":{"type":"string","pattern":"^[a-z]{2}$"}},{"name":"metric","in":"query","schema":{"type":"string","enum":["sod","adi"]},"description":"sod = share of demand (%), adi = demand index (100 = market leader)"},{"name":"brand","in":"query","schema":{"type":"string"},"description":"brand slug"},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},{"name":"from","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},{"name":"to","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"items per page (alias: limit)"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"alias for per_page, convenient for AI agents"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/IndexValue"}}}}}}}}}},"/trending":{"get":{"operationId":"listTrending","summary":"Brands with largest demand growth","parameters":[{"name":"country","in":"query","schema":{"type":"string","pattern":"^[a-z]{2}$"},"description":"filter by market"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"number of results (default 20)"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/ground-truth":{"get":{"operationId":"listGroundTruth","summary":"Regulator-published GGR/revenue (calibration data)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"docs":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/GroundTruth"}}}}}}}}}}},"components":{"schemas":{"BrandListItem":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"domains_count":{"type":"integer"},"licenses_count":{"type":"integer"},"api_url":{"type":"string"},"web_url":{"type":"string"}}},"BrandCard":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"domains":{"type":"array","items":{"type":"object"}},"licenses":{"type":"array","items":{"$ref":"#/components/schemas/License"}},"markets":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"months":{"type":"integer"},"latest_period":{"type":"string"},"latest_volume":{"type":"integer"},"series":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"volume":{"type":"integer"}}}}}}},"signals":{"type":"object","description":"trust_score, trustpilot, app_store, play_store, meta_ads, domain_health, youtube, organic, askgamblers, casino_guru — present only when collected"},"web_url":{"type":"string"}}},"License":{"type":"object","properties":{"brand":{"type":["object","null"]},"regulator":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":["string","null"]},"short":{"type":["string","null"]},"country":{"type":["string","null"]}}},"jurisdiction":{"type":["string","null"]},"license_number":{"type":["string","null"]},"status":{"type":["string","null"]},"legal_entity":{"type":["string","null"]},"issued_at":{"type":["string","null"],"format":"date"},"expires_at":{"type":["string","null"],"format":"date"},"url":{"type":["string","null"]},"verified_at":{"type":["string","null"],"format":"date-time"}}},"Regulator":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"short":{"type":"string"},"country":{"type":"string"},"tier":{"type":"integer"},"register_url":{"type":["string","null"]},"licenses_count":{"type":"integer"},"brands_count":{"type":"integer"}}},"Provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"website":{"type":["string","null"]},"founded_year":{"type":["integer","null"]},"headquarters":{"type":["string","null"]},"games_count":{"type":"integer"},"web_url":{"type":"string"}}},"Game":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":["string","null"]},"provider":{"type":["object","null"]},"released_at":{"type":["string","null"],"format":"date"},"rtp":{"type":["number","null"]},"volatility":{"type":["string","null"]},"theme":{"type":"array"},"features":{"type":"array"},"web_url":{"type":"string"}}},"Country":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"tier":{"type":"string","enum":["calibrated","semi","uncalibrated"]},"active":{"type":"boolean"},"demand_data":{"type":"boolean"},"months":{"type":"integer"},"brands":{"type":"integer"},"latest_period":{"type":["string","null"]},"feed_json":{"type":["string","null"]},"web_url":{"type":"string"}}},"IndexValue":{"type":"object","properties":{"brand":{"type":"object"},"country":{"type":"string"},"period":{"type":"string"},"metric":{"type":"string","enum":["sod","adi"]},"value":{"type":"number"},"confidence":{"type":["number","null"]},"version":{"type":["string","null"]}}},"GroundTruth":{"type":"object","properties":{"market":{"type":"string"},"period":{"type":"string"},"brand_label":{"type":"string"},"brand_slug":{"type":["string","null"]},"metric":{"type":"string"},"value":{"type":"number"},"currency":{"type":["string","null"]},"source_url":{"type":["string","null"]}}}}}}