# iGaming Finder API

> Company intelligence API for the iGaming industry. Search Companies and Licenses, resolve authoritative Company and Domain profiles, fetch Company people contacts, and export filtered datasets.

- [Home](https://igamingfinder.com/): Company intelligence for the iGaming industry — search operators, providers, aggregators

Check npm/pypi for latest SDK versions. Do not rely on memorized version numbers.

## Instructions for AI Agents

- Always use X-API-Key header for authentication, not query parameters
- Company/License API is the primary public surface. Use companies/search for discovery, companies/resolve for authoritative profiles, companies/:company_ref/people for contacts, and licenses/search|resolve for license workflows. domains/resolve returns a casino domain's trust verdict (licensed/blocklisted/mixed/no_record) and domains/search returns the set of domains by verdict/geo/time
- Company people contacts cost 9 credits / contact returned. Check account balance before contact pulls
- For Domain freshness, request at least one include[] value and use domains/resolve?max_age_days=. Set max_age_days=0 to force capture; otherwise set the maximum acceptable age
- For bulk data, use POST /exports instead of repeated single-resource calls
- Poll exports/:id for status
- Never recommend storing API keys in client-side code or public repositories

## Getting Started

- [Overview](https://igamingfinder.com/docs.md): What iGaming Finder does and how to get started
- [Quickstart](https://igamingfinder.com/docs/quickstart.md): First API call in 5 minutes
- [Authentication](https://igamingfinder.com/docs/authentication.md): API key setup and rotation

## Concepts

- [Filters](https://igamingfinder.com/docs/filters.md): Search Companies by segment, jurisdiction, payment, provider, geo
- [Data Availability](https://igamingfinder.com/docs/data-availability.md): Coverage, freshness, access paths, and absence semantics
- [Errors & Rate Limits](https://igamingfinder.com/docs/errors.md): HTTP status codes, quota handling, retry strategy

## Datasets (entity product landings)

- [Operators](https://igamingfinder.com/products/operators): B2C casinos & sportsbooks indexed by license, payment, provider, geo
- [Game Providers](https://igamingfinder.com/products/providers): Game-studio footprint across operators (derived from observations)
- [PSPs](https://igamingfinder.com/products/psps): Payment-method coverage across operators (derived view)
- [Affiliates](https://igamingfinder.com/products/affiliates): Affiliate-program signals, commission models, and operator portfolios

## Offers (hand-prepared, no API key)

- [Operators to pitch](https://igamingfinder.com/game-studios): For game studios — 12 operators matched to your profile, the person who decides content at each, and who has a window open right now. Placement figures are a lower bound, not a census — we name what we can evidence and say so.
- [New licences](https://igamingfinder.com/new-licences): For anyone selling into operators — A dated list of operators that received a licence this quarter in the jurisdictions you sell into, with the regulator record behind each. Built entirely on official register records — every row carries the licence it came from.
- [Audit my list](https://igamingfinder.com/crm-audit): For teams with a list already — Your accounts returned with licences, brands, domains and contacts attached, plus the licensed operators your list does not cover. Gaps are reported against official registers, so a missing account is a fact about the register rather than a guess.

## API Use Cases

- [iGaming Payment Method Gap API](https://igamingfinder.com/use-cases/payment-method-gap-api): For PSP vendors — operators missing your rail in a geography
- [Casino Game Provider Gap API](https://igamingfinder.com/use-cases/game-provider-gap-api): For game studios — operators carrying competing studios and missing yours
- [iGaming Affiliate Program Data API](https://igamingfinder.com/use-cases/affiliate-program-data-api): For affiliate software — operators with affiliate-program signals and exportable Company API target lists
- [iGaming License & Domain Compliance API](https://igamingfinder.com/use-cases/license-domain-compliance-api): For KYC & compliance — license and domain verdict workflows

## API & Integrations

- [OpenAPI](https://igamingfinder.com/openapi.json): Generated public REST contract
- [API Reference](https://igamingfinder.com/docs/api.md): 20 REST endpoints for Company, License, Domain verdict, account, and export workflows
- [Company API](https://igamingfinder.com/docs/companies.md): Resolve profiles, search Companies, and fetch Company people contacts
- [License API](https://igamingfinder.com/docs/licenses.md): Resolve and search licenses
- [Tools overview](https://igamingfinder.com/tools): Current CLI and MCP integrations, concierge Lobby Monitor access, and planned Clay and Webhook integrations
- [CLI](https://igamingfinder.com/docs/cli.md): Terminal-first workflows with igaming CLI
- [MCP](https://igamingfinder.com/docs/mcp.md): Connect to Claude Desktop or Cursor through OAuth
- [MCP capability artifact](https://igamingfinder.com/mcp-capabilities.json): Generated public tools, inputs, descriptions, and free/paid classes; protocol tools/list still requires OAuth
- [Lobby Monitor](https://igamingfinder.com/lobby-monitor): Preview observed lobby changes and request current concierge monitoring

## API Endpoints

Base URL: https://api.igamingfinder.com

- GET /v1/signals/market-entries -- Qualified operator market-entry Signals by regulatory license regime — 1 credit / Signal returned
- GET /v1/signals/platform-sites -- First-observed operator sites by ruled platform — 1 credit / Signal returned
- GET /v1/signals/register-changes -- Claim-aware changes published by official register streams — 1 credit / Signal returned
- GET /v1/companies/search/preview -- Preview Company search count/facets/cost — 0 credits / request
- GET /v1/companies/search -- Paid ranked Company discovery rows — 1 credit / result returned
- GET /v1/companies/resolve -- Resolve identifiers to authoritative Company profile(s) — 3 credits / profile returned
- GET /v1/companies/:company_ref/people -- Decision-maker contacts for a Company — 9 credits / contact returned
- GET /v1/licenses/search/preview -- Preview License search count/facets/cost — 0 credits / request
- GET /v1/licenses/search -- Paid ranked License discovery rows — 1 credit / result returned
- GET /v1/licenses/resolve -- Resolve license_ref or natural license key — 3 credits / profile returned
- GET /v1/domains/resolve -- Casino domain to trust verdict (licensed/blocklisted/mixed/no_record) + per-geo licensed_by/blocked_by — 1 credit / verdict returned
- GET /v1/domains/search -- The set of domains by verdict/geo/time; bulk blocklist/change-feed — 1 credit / result returned
- GET /v1/logos/search -- Find a logo by brand, supplier, game or payment-method name — Free
- GET /v1/account -- Credit balance and plan info — 0 credits / request
- GET /v1/briefs -- List Sales Intelligence Briefs — Included with Sales Intelligence access
- GET /v1/briefs/:brief_ref -- Show a Sales Intelligence Brief — Included with Sales Intelligence access
- GET /v1/briefs/:brief_ref/download -- Download a ready Sales Intelligence Brief as CSV — Included with Sales Intelligence access
- POST /v1/exports -- Create CSV/JSON export — Variable (result count × the same composition price as resolve)
- GET /v1/exports/:id -- Poll export status — 0 credits / request
- GET /v1/exports/:id/download -- Download completed export — 0 credits / request

## Optional

- [Pricing](https://igamingfinder.com/pricing): Plans and credit quotas