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. See Data Availability for where each dataset is available, coverage, freshness, and what a missing value means.

$ help --topic=info

▸ The explicit value filters payment_method, supplier_brand, and platform are paid-search only. A free-text q that resolves to a curated platform brand is also treated as a paid platform query. On the free preview these inputs return 400 preview_payload_filter, because a free match count filtered by a paid value would reveal that value one query at a time. Size your query with payment_category, geo, jurisdiction, role, license_status, has_platform, or affiliate_program — the dimensions the preview already counts — then apply method, supplier, platform, or platform-brand query values on the paid call.

curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/v1/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/market-entries lists operator changes on one market's official register: the same rows, with the same refs, that GET /signals/register-changes returns. It does not list every operator active in a country.

Pass next_cursor back as after with the same row filters and send a new Idempotency-Key for each page. If you lose a cursor, older rows can be delivered and billed again. Only rows that the register lists as operators appear in this view.

Domain Resolve Include Controls

GET /domains/resolve accepts the same exact plural section keys used across the API, plus operator_launch_profile. operator_launch_profile is not another name for one section: it adds registration, DNS, web presence, launch state, the legal names published on the site, public website contacts, related domains and coverage.

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.

include[]=logos is different in kind and costs nothing on top of the verdict you already paid for: no new check of the site runs to answer it, so it carries no enrichment cost and never triggers a refresh. It returns every mark held for the host, oldest first, superseded ones included — each with current, first_seen_at and superseded_at, because a rebrand has a date and the date is the signal. It answers for a host we hold a logo for even when we hold no other record of it.

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

Send a new 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.

q=crypto curacao

role

Filter by the Company's public role. A Company can be any kind of iGaming business; operator is one role, not a separate response format.

role=operator

A company holds every role its licences state, so role on a response is a list and role=operator means operator is among its roles — a company that both operates and supplies matches it. Role counts therefore do not sum to found: a company is counted under each role it holds.

jurisdiction

Filter by license jurisdiction.

jurisdiction=mga

license_status

Filter by the status of a Company's licenses.

license_status=active

payment_category

Filter by accepted payment method category.

payment_category=crypto

payment_method

Filter Companies whose Domains were observed accepting a specific standard payment method name.

payment_method=skrill

Paid search only — see the note at the top of this page. A Company missing from the result may be outside observed coverage; it is not proof that the method is absent.

supplier_brand

Filter Companies whose Domains were observed carrying content from a specific supplier brand — a game studio or an aggregator. Use the normalized brand name.

This filter matches only suppliers seen supplying content, such as games, to operators. A supplier seen in another capacity — a sportsbook platform, a payment provider — is not matched here, because a content placement and a platform detection are different observations and are never summed.

supplier_brand=evolution
supplier_brand=pragmatic-play

Paid search only — see the note at the top of this page.

platform

Filter Companies by a reviewed platform published for their Domains. Use the curated platform name.

platform=digitain

Paid search only — see the note at the top of this page. This is separate from supplier_brand: a platform detection and a content placement are different observations.

has_platform

Filter on whether a reviewed platform is published for the Company.

has_platform=true
has_platform=false

has_platform=false means no reviewed platform is currently published. It does not prove that the Company runs no platform.

affiliate_program

Only return Companies with detected affiliate programs.

affiliate_program=true

geo

Filter by geographic targeting hint.

geo=BR

Pagination

curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/v1/companies/search?q=crypto&page=2&page_size=50&max_credits=50"

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

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

Combining Filters

Filters are AND-combined. Size the result on the free preview with these filter dimensions:

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

Then narrow to Evolution games on the paid call, which bills per row returned:

curl -H "X-API-Key: igf_demo_9457cf242d0c43404fb69b8273d7f4371716682a12c74e3c3274fd8957ebeae7" \
  "https://api.igamingfinder.com/v1/companies/search?jurisdiction=mga&payment_category=crypto&supplier_brand=evolution&page_size=20&max_credits=20"