iGaming Finder

Overview

The GET /companies/search endpoint (and its free GET /companies/search/preview) accept filters as query parameters. All filters are optional and can be combined. Preview first to see the match count and cost, then pull paid rows.

bash 
curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/api/v1/igaming/companies/search/preview?q=crypto&jurisdiction=anjouan&payment_category=crypto&affiliate_program=true"
$ help --topic=info
Search returns thin discovery rows — Companies with payment/provider categories and counts. To get enumerated payment methods, nested licenses, or full domain mappings, take a row's company_ref and call GET /companies/resolve.

Signal Feed Filters

GET /signals uses a regulatory license-regime cohort, not unrestricted operating geography.

Parameter Meaning
kind Required; V1 is licensed_market_entry
market Required; ukgc, mga, curacao, or anjouan
occurred_from, occurred_to ISO dates applied to authoritative License issued_at
after Opaque monotonic cursor bound to kind, market, and occurrence-date filters
page Cursor-only feed; the only accepted value is 1
page_size Default 10, maximum 20; maximum 5 with contacts requested
include[] Optional firmographics and/or contacts; currently reported as unavailable without an optional charge
domains[] Up to 3 exact authorized domains, reserved for unavailable V1 compositions
contacts_limit 1–3 contacts per selected domain, reserved for unavailable V1 compositions
max_age_days 0–365 freshness band, reserved for unavailable V1 compositions
max_credits Whole-request cost ceiling

A correction keeps the same signal_ref and advances the cursor position. Pass next_cursor back as after with the same row filters and use a fresh idempotency key per page; an empty poll preserves the cursor. Losing a cursor can redeliver and rebill older rows. Do not use the regulator country code as a claim about where every licensee operates.

Domain Resolve Composition Controls

GET /domains/resolve accepts the same exact plural facet keys used across the API plus the operator_launch_profile composition macro. The macro is not a facet alias: it composes registration, DNS, web presence, launch state, legal claims, public website contacts, related domains, quality, coverage, and evidence.

Parameter Meaning
domain Required casino URL or host; normalized to the registrable domain
include[] Add operator_launch_profile to request the paid composition
max_age_days 0 forces capture; otherwise refresh evidence older than this many days
max_credits Whole-request ceiling; use 6 for one verdict plus one available profile

An unavailable profile returns HTTP 200 with an explicit reason and costs only the 1-credit base verdict. An available profile is one atomic 6-credit delivery: 1 credit for domain.verdict plus 5 for domain.operator_launch_profile. Unknown include values are rejected before charging.

bash 
curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  -H "Idempotency-Key: YOUR_FRESH_REQUEST_KEY" \
  "https://api.igamingfinder.com/api/v1/igaming/domains/resolve?domain=ncc.bet&include[]=operator_launch_profile&max_age_days=7&max_credits=6"

Use a fresh idempotency key for each new request. Repeating the exact same key and parameters replays without another debit; changing any request parameter under that key returns 409 idempotency_key_reused.

Available Company Filters

q

Free-text query across Company names, brands, and domains.

bash 
q=crypto curacao

role

Filter by the Company's public role. Company is the umbrella resource; operator is one role, not a separate response schema.

Value Description
operator Customer-facing casino or sportsbook operator
aggregator Game or content aggregator
platform_provider Casino platform, PAM, or white-label provider
payment_provider Payment service provider
game_studio Game studio or content supplier
affiliate_software Affiliate tracking software or tooling
affiliate_media Affiliate media or comparison publisher
other_supplier Other supplier
bash 
role=operator

jurisdiction

Filter by license jurisdiction.

Value Jurisdiction
mga Malta Gaming Authority
ukgc UK Gambling Commission
curacao Curacao eGaming
anjouan Anjouan (Comoros)
bash 
jurisdiction=mga

license_status

Filter by the status of a Company's licenses.

bash 
license_status=active

payment_category

Filter by accepted payment method category.

Value Description
card Visa, Mastercard, etc.
crypto Bitcoin, Ethereum, USDT, etc.
ewallet Skrill, Neteller, ecoPayz, etc.
bank_transfer Wire transfers
open_banking Trustly, instant bank pay
local_apm Region-specific methods (Pix, UPI, etc.)
bash 
payment_category=crypto

game_provider

Filter Companies that feature a specific game provider. Use the normalized provider name.

bash 
game_provider=evolution
game_provider=pragmatic-play

affiliate_program

Only return Companies with detected affiliate programs.

bash 
affiliate_program=true

geo

Filter by geographic targeting hint.

bash 
geo=BR

Pagination

Parameter Default Max Description
page 1 — Page number
page_size 20 100 Rows per page (you are charged per row returned)
max_credits — — Hard cost ceiling for the pull
bash 
curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/api/v1/igaming/companies/search?q=crypto&page=2&page_size=50&max_credits=50"

The response includes total, page, and page_size for pagination:

json 
{
  "data": {
    "hits": [...],
    "total": 1420,
    "page": 2,
    "page_size": 50
  }
}

Combining Filters

Filters are AND-combined. This query previews MGA-licensed Companies that accept crypto and feature Evolution games:

bash 
curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/api/v1/igaming/companies/search/preview?jurisdiction=mga&payment_category=crypto&game_provider=evolution"