Installation

bash

npm install -g @igamingfinder/cli
igamingfinder --help

Or run without installing: npx -y @igamingfinder/cli --help (Node 18+).

$ help --topic=early-access

The CLI is in early access. Sign up free to get your API key.

Authentication

No account yet? igamingfinder signup opens the signup page. New accounts get welcome bonus credits, and the link in the email we send you finishes registration. Then:

bash

igamingfinder config set-key client_YOUR_KEY
# or: export IGAMINGFINDER_API_KEY=client_YOUR_KEY

Your key is stored locally in ~/.config/igamingfinder/config.json. Check the active configuration with igamingfinder config show.

Credits

Previews, account, logos search, people roles and prospect lists are free. Each paid command says in its --help how it is billed, and every paid response includes credits_charged. Add --max-credits <n> to a paid command to refuse a call that would cost more than that.

Commands

Signals

bash

# Operator changes on the Anjouan register: one credit per Signal row
igamingfinder signals market-entries --role operator --market anjouan --page-size 5

# The next page: pass next_cursor from the previous response
igamingfinder signals market-entries --role operator --market anjouan \
  --after 'igfcur_...' --page-size 5

# Revocations on the UKGC register
igamingfinder signals register-changes --jurisdiction ukgc --event-type revoked

# Operator sites first seen on one platform
igamingfinder signals platform-sites --role operator --platform digitain

market-entries lists operator changes on one market's official register. Each row has a signal_ref, the company name as the register publishes it, and the type of change. The same rows also appear in register-changes. Only rows that the register lists as operators are included. The output also contains billing and a next_cursor.

To get the next page, pass next_cursor as --after and keep the same --role, --market, --occurred-from and --occurred-to. If a cursor is rejected, start again without --after.

In register-changes, a license number or a matched company may be missing for some register rows. Removal from a register does not mean the license was revoked; only a revoked row says that. In platform-sites, the date is when we first saw the site on that platform, not when it moved.

Companies

bash

igamingfinder companies preview --jurisdiction mga    # free: result count + cost estimate
igamingfinder companies search  --jurisdiction mga    # paid company search
igamingfinder companies resolve --domain stake.com    # full company profile (paid)
igamingfinder companies people  igfc_a1b2c3           # decision-maker contacts (paid)

preview costs 0 credits. Run it before search to see how many rows match and what they cost.

Every domain in a company profile has a domain_ref. Firmographics, which describe the business behind a domain, are an extra paid section:

bash

# Firmographics for one domain
igamingfinder companies resolve --company-ref igfc_a1b2c3 --include firmographics \
  --domain-ref igfd_d4e5f6 --max-age-days 30

# Firmographics for every eligible domain; no older data if a refresh fails
igamingfinder companies resolve --company-ref igfc_a1b2c3 --include firmographics \
  --allow-stale-on-error false

Without --domain-ref, you get firmographics for every eligible domain, and each domain result is billed at the rate below. A domain with no result costs nothing. Set --max-credits to the most you want to spend on the profile and all its domains.

Cost: 12 credits / delivered Domain result

Licenses

bash

igamingfinder licenses preview --jurisdiction ukgc
igamingfinder licenses search  --jurisdiction mga --page-size 25
igamingfinder licenses resolve igfl_a1b2c3

Domain Verdicts

bash

igamingfinder domains resolve roobet.com                       # trust verdict for one domain
igamingfinder domains resolve ncc.bet --include operator_launch_profile \
  --max-age-days 7 --max-credits 6                             # verdict + launch profile
igamingfinder domains search --verdict blocklisted --geo pl    # bulk blocklist

domains search accepts --since, --until and --dropped-before (ISO 8601) to find domains that were blocklisted or left the blocklist in a date range.

The terminal output of the Operator Launch Profile shows whether a profile is available, the launch state, the Licensee on the register, the legal names on the site, the number of website emails, the number of related domains, when we checked, and the cost. --json returns the full response. The Licensee on the register, the website operator named on the site, and technical links such as shared hosting are shown separately. A technical link does not show who owns a site.

--max-age-days N refreshes the requested sections that are older than N days before the answer comes back; 0 always refreshes. A refresh can take up to 240 seconds, so scripts that run the CLI should allow at least 300 seconds.

bash

igamingfinder domains resolve ncc.bet --include operator_launch_profile --max-age-days 7 --max-credits 6
igamingfinder domains resolve bc.game --include payment_methods --max-age-days 7
igamingfinder companies resolve --domain stake.com --include firmographics --domain-ref igfd_d4e5f6 --max-age-days 30

An available profile costs 6 credits in total: 1 for the verdict and 5 for the profile. If no profile is available, the response says why and you pay only the 1-credit verdict.

Logos

bash

igamingfinder logos search pragmatic                           # find a logo by name
igamingfinder logos search skrill --kind payment_method        # only one kind of logo
igamingfinder logos search "book of ra" --json                 # machine-readable

Free. Each row has name, kind, slug, domain, role and logo_url and nothing else. kind and domain only build the image address (img.igamingfinder.com/{domain}); they do not mean the company owns that domain. role says what the company does and is empty when we do not know. The search needs at least three characters and returns at most ten rows with no paging. Use it to check whether we have a logo, not to list all logos.

The image itself needs no key at all — https://img.igamingfinder.com/{domain} redirects to the stored file, or serves a monogram when we hold no logo, so an <img> never breaks.

People roles

bash

igamingfinder people roles                                     # the role keys
igamingfinder people roles --json                              # machine-readable
igamingfinder companies people <company_ref> --role compliance # use a key as a filter

Free. Each key has a one-sentence meaning, seniority, function, the job-title spellings it matches, and how many people it matched when we last measured. Pass a key as --role; any other text is matched as free text. The job title decides the match; the headline is used only for people with no job title.

Prospect lists

Request a prospect list with the public request form or the Dashboard form at /prospect-lists/new. The CLI only reads prospect lists: prospect-lists list, prospect-lists show and prospect-lists download are free.

bash

igamingfinder prospect-lists list --status ready --page-size 20
igamingfinder prospect-lists show igfpl_example
igamingfinder prospect-lists download igfpl_example -o prospect-list.csv

prospect-lists show shows the results only when the list is ready, and prospect-lists download returns CSV only for a ready list. A prospect list carries only data you can verify: accounts, their organizations, licences and brands, and named contacts. The CLI does not send messages.

Account

bash

igamingfinder account

Shows your plan and credit balance (granted, used, reserved, available).

Output Formats

Default output is formatted for the terminal. Commands with a table view accept --json, and data commands switch to JSON automatically when piped:

bash

igamingfinder signals market-entries --role operator --market anjouan \
  | jq -r '.signals[] | [.signal_ref, .subject.published_legal_name, .license.license_number] | @tsv'
igamingfinder companies search --jurisdiction mga --json | jq -r '.hits[] | .primary_domain.domain // empty'
igamingfinder domains search --verdict blocklisted --json | jq -r '.domains[].domain'

Commands compose — resolve every domain a search returned:

bash

igamingfinder companies search --jurisdiction mga --json \
  | jq -r '.hits[] | .primary_domain.domain // empty' \
  | xargs -n1 igamingfinder domains resolve

Shell completion

Generate a completion script for your shell (completes command, subcommand, and flag names):

bash

igamingfinder completion fish > ~/.config/fish/completions/igamingfinder.fish
igamingfinder completion zsh  > "${fpath[1]}/_igamingfinder"   # then run: compinit
igamingfinder completion bash > ~/.local/share/bash-completion/completions/igamingfinder

MCP Server

The same binary includes the MCP server for Claude Desktop and Cursor: igamingfinder mcp.

$ help --topic=command-discovery

Run igamingfinder --help for the full command list, or igamingfinder <command> --help for command-specific options.