# 123offerte.it GET catalogue

Search Italian offers. Add filters to a tool link below; no sign-in. Readable fact sheets by default; format=json returns the unchanged MCP structured content. locale=it (default) or locale=en. Unknown never means zero. Preserve qualifications and cite offer links.

Numbers: 100; booleans: true/false; lists: repeated parameters or comma-separated values; nested objects: URL-encoded JSON. Follow Next for more results. Search first, then use returned Details links. Detail and comparison examples use current published IDs.

## search_mobile_plans

- [search_mobile_plans?minimum_data_gb=100&require_5g=true](https://123offerte.it/api/ai/search_mobile_plans?minimum_data_gb=100&require_5g=true)
- [search_mobile_plans?minimum_data_gb=200&require_esim=true](https://123offerte.it/api/ai/search_mobile_plans?minimum_data_gb=200&require_esim=true)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- max_monthly_price_eur: number ≥0 ≤100. Maximum displayed comparable monthly equivalent. Qualified quotes retain their conditions; unknown prices do not match.
- current_operator: iliad | italia_power | massima_energia | ho | very_mobile | fastweb | cmlink | coopvoce | daily_telecom | digi_mobil | ehiweb_mobile | enel | feder_mobile | green_mobile | kena_mobile | lyca_mobile | netoip | noitel | nvmobile | optima_italia | postemobile | segnoverde | sky | spusu | tim | tiscali | unomobile | vianova | vodafone | windtre. Current operator ID. Known port-in exclusions retain new-number alternatives; check entry_paths and eligibility before promising number retention.
- minimum_data_gb: 10 | 50 | 100 | 200 | 500
- require_5g: true
- require_esim: true
- kinds: list(voice_data | data_only | iot | pay_as_you_go | other)
- audience (required): consumer_candidate | business_only; default consumer_candidate
- sort (required): price-asc | price-desc | name; default price-asc

## search_current_accounts

- [search_current_accounts?max_monthly_fee_eur=0](https://123offerte.it/api/ai/search_current_accounts?max_monthly_fee_eur=0)
- [search_current_accounts?required_features=joint_account](https://123offerte.it/api/ai/search_current_accounts?required_features=joint_account)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- max_monthly_fee_eur: number ≥0 ≤100. Maximum comparable ordinary management fee, excluding other charges; unknown prices do not match.
- required_features: list(no_ordinary_management_fee | conditional_zero_available | introductory_zero_available | joint_account | branch_banking | cash_deposits | italian_iban | f24_payments | debit_card_available | english_customer_support | apple_pay | google_pay). All must be explicitly true. Conditional zero availability does not mean an unconditional free account.
- sort (required): fee-asc | fee-desc | name; default fee-asc

## search_home_internet

- [search_home_internet?technologies=ftth&minimum_download_mbps=1000](https://123offerte.it/api/ai/search_home_internet?technologies=ftth&minimum_download_mbps=1000)
- [search_home_internet?require_modem_included=true](https://123offerte.it/api/ai/search_home_internet?require_modem_included=true)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- profile_id: string. Exact published profile_id. Required when connection filters do not identify a single profile for a profile-specific price.
- technologies: list(ftth | fttc | adsl | fwa)
- minimum_download_mbps: 100 | 300 | 1000 | 2500
- minimum_upload_mbps: 20 | 100 | 300 | 1000
- max_monthly_price_eur: number ≥0 ≤100. Maximum displayed comparable monthly equivalent. Qualified quotes retain their conditions; unknown prices do not match.
- require_modem_included: true
- sort (required): price-asc | price-desc | name; default price-asc

## search_credit_cards

- [search_credit_cards?max_annual_fee_eur=0](https://123offerte.it/api/ai/search_credit_cards?max_annual_fee_eur=0)
- [search_credit_cards?sort=fee-asc&limit=3](https://123offerte.it/api/ai/search_credit_cards?sort=fee-asc&limit=3)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- max_annual_fee_eur: number ≥0 ≤1000. Annual membership fee, excluding other charges; unknown fees do not match.
- required_features: list(no_ordinary_membership_fee | conditional_zero_available | introductory_zero_available | full_balance | installments | revolving | visa | mastercard | amex | virtual_card_available | apple_pay | google_pay)
- sort (required): fee-asc | fee-desc | name; default fee-asc

## search_personal_loans

- [search_personal_loans?amount_eur=15000&term_months=60](https://123offerte.it/api/ai/search_personal_loans?amount_eur=15000&term_months=60)
- [search_personal_loans?amount_eur=10000&term_months=48](https://123offerte.it/api/ai/search_personal_loans?amount_eur=10000&term_months=48)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- amount_eur: integer ≥1 ≤1000000
- term_months: integer ≥1 ≤480
- required_features: list(fixed_rate_available | variable_rate_available | debt_consolidation_available | skip_installment_available | joint_borrower_available | guarantor_available | purpose_education | purpose_home | purpose_mobility | purpose_health | purpose_family | purpose_sustainability | purpose_career_start)
- sort (required): apr-asc | name; default apr-asc

## search_energy

- [search_energy?kind=electricity&annual_kwh=4000](https://123offerte.it/api/ai/search_energy?kind=electricity&annual_kwh=4000)
- [search_energy?kind=gas&annual_smc=1400](https://123offerte.it/api/ai/search_energy?kind=gas&annual_smc=1400)
- [search_energy?kind=dual&annual_kwh=2700&annual_smc=1400](https://123offerte.it/api/ai/search_energy?kind=dual&annual_kwh=2700&annual_smc=1400)

- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- limit (required): integer ≥1 ≤20; default 10
- offset (required): integer ≥0 ≤100000; default 0
- providers: list(string). Exact provider IDs from results; unknown IDs are rejected.
- kind (required): electricity | gas | dual
- annual_kwh: integer ≥100 ≤25000. Annual electricity consumption. Website default: 2700 kWh.
- annual_smc: integer ≥100 ≤25000. Annual gas consumption. Website default: 1400 Smc.
- price_types: list(fixed | indexed | mixed | unknown)
- sort (required): estimate | standing | seller; default estimate

## get_product

- [get_product?id=tiscali%3Asmart-connect&category=mobile_plans](https://123offerte.it/api/ai/get_product?id=tiscali%3Asmart-connect&category=mobile_plans)
- [get_product?id=very_mobile%3Aofferte%2Fvery-things-199&category=mobile_plans](https://123offerte.it/api/ai/get_product?id=very_mobile%3Aofferte%2Fvery-things-199&category=mobile_plans)

- category: mobile_plans | current_accounts | home_internet | credit_cards | personal_loans | electricity | gas | dual
- id (required): string
- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- connection: JSON {profile_id: string, technologies: list(ftth | fttc | adsl | fwa), minimum_download_mbps: 100 | 300 | 1000 | 2500, minimum_upload_mbps: 20 | 100 | 300 | 1000}. Home internet only. Reuse the search connection filters to preserve the same connection in details, comparison and website links. Both speeds must match one published profile; address availability is not checked.
- loan: JSON {amount_eur: integer ≥1 ≤1000000, term_months: integer ≥1 ≤480}. Personal loans only. Reuse the search amount and term; examples are not personalized quotes.
- energy: JSON {annual_kwh: integer ≥100 ≤25000, annual_smc: integer ≥100 ≤25000}. Energy only. Reuse search consumption to retain the same monthly estimate. No address availability check.
- price_id: string. Home internet and banking only: confirmation of ALL conditions on one returned selectable price option. Mobile uses terms, not price_id. Never infer qualification.

## compare_products

- [compare_products?category=mobile_plans&ids=tiscali%3Asmart-connect,very_mobile%3Aofferte%2Fvery-things-199&locale=it](https://123offerte.it/api/ai/compare_products?category=mobile_plans&ids=tiscali%3Asmart-connect,very_mobile%3Aofferte%2Fvery-things-199&locale=it)
- [compare_products?category=mobile_plans&ids=tiscali%3Asmart-connect,very_mobile%3Aofferte%2Fvery-things-199&locale=en](https://123offerte.it/api/ai/compare_products?category=mobile_plans&ids=tiscali%3Asmart-connect,very_mobile%3Aofferte%2Fvery-things-199&locale=en)

- category (required): mobile_plans | current_accounts | home_internet | credit_cards | personal_loans | electricity | gas | dual
- ids (required): list(string)
- locale (required): it | en; default it. Website link language; source terms may remain Italian.
- connection: JSON {profile_id: string, technologies: list(ftth | fttc | adsl | fwa), minimum_download_mbps: 100 | 300 | 1000 | 2500, minimum_upload_mbps: 20 | 100 | 300 | 1000}. Home internet only. Reuse the search connection filters to preserve the same connection in details, comparison and website links. Both speeds must match one published profile; address availability is not checked.
- loan: JSON {amount_eur: integer ≥1 ≤1000000, term_months: integer ≥1 ≤480}. Personal loans only. Reuse the search amount and term; examples are not personalized quotes.
- energy: JSON {annual_kwh: integer ≥100 ≤25000, annual_smc: integer ≥100 ≤25000}. Energy only. Reuse search consumption to retain the same monthly estimate. No address availability check.
- price_selections: list(JSON {product_id: string, price_id: string, connection: JSON {profile_id: string, technologies: list(ftth | fttc | adsl | fwa), minimum_download_mbps: 100 | 300 | 1000 | 2500, minimum_upload_mbps: 20 | 100 | 300 | 1000}}). At most one explicitly confirmed complete price option per compared product.