Search the Infobel worldwide business database.

IMPORTANT — record_fields is required. You MUST decide upfront which fields you need. Pass [] (empty list) for counts-only queries. uniqueID is always included automatically so callers can fetch full records.

Use-case examples for record_fields: Counts only (no records): record_fields=[] → Returns searchId + counts only (fastest, cheapest)

Name matching / deduplication: record_fields=["businessName", "tradeName", "companyName", "directoryName"]

Address verification: record_fields=["businessName", "address1", "address2", "postCode", "city", "province", "countryCode"]

Contact lookup: record_fields=["businessName", "phone", "email", "website"]

Full identity + location: record_fields=["businessName", "tradeName", "nationalID", "address1", "postCode", "city", "countryCode"]

Available field names (camelCase, as returned by the API): Identity: uniqueID, businessName, companyName, tradeName, directoryName, diasCode, nationalID, universalPublicationId Address: address1, address2, addressStreet, addressHouseNumber, postCode, city, cityCode, locality, localityCode, province, provinceCode, region, regionCode, country, countryCode Contact: phone, mobile, fax, email, website, webDomain, phoneOrMobile Corporate: yearStarted, employeesTotal, employeesHere, salesVolume, salesVolumeDollars, salesVolumeEuros, statusCode, statusCodeName, hierarchyCode, subsidiaryIndicator, importExportAgentCode, legalStatus Executive: ceoName, ceoTitle Geo: latitude, longitude, geoLevel, geoLevelDescription Digital: hasEShop, hasPayment, hasDigitalMarketing, hasShopTool, hasBuildingGeometry, hasMarketability, dncmPhone, websiteStatusFlag, websiteUUID, websiteIpAddress, websiteCrawlDate, webDomainUUID Linkage: parentLinkage, domesticLinkage, globalLinkage, familyMembers Categories: internationalCode01-06, infobelCode01-10, localCode01-15, altInternationalCode01-06, internationalCategories, altInternationalCategories Financial: financialHistory, salesVolumeReliabilityCode, employeesTotalReliabilityCode, employeesHereReliabilityCode Misc: language, reportDate, additionalInfos, genericSocialLinks

Returns JSON with: searchId — use with get_search_results for subsequent pages counts — total, hasPhone, hasEmail, etc. records — list of field-filtered records (empty when record_fields=[]) page — current page number (omitted when record_fields=[])

Args: country_codes: ISO 3166-1 alpha-2 country codes (e.g. ["GB", "DE"]). record_fields: Fields to return per record. Empty list = counts only. uniqueID is always included automatically. business_name: Business names to search for (e.g. ["Acme Corp"]). business_name_exclusive: Business names to exclude. national_id: National registration numbers to include. national_id_exclusive: National registration numbers to exclude. unique_ids: Infobel unique IDs to look up directly. unique_ids_exclusive: Infobel unique IDs to exclude. city_names: Filter by city names (e.g. ["London", "Manchester"]). city_codes: Filter by city codes. city_codes_exclusive: City codes to exclude. province_names: Filter by province/state names. province_codes: Filter by province codes. province_codes_exclusive: Province codes to exclude. region_names: Filter by region names. region_codes: Filter by region codes. region_codes_exclusive: Region codes to exclude. post_codes: Filter by postal/zip codes. post_codes_exclusive: Postal codes to exclude. street_address: Street address filter. house_number: House number filter. coordinate_latitude: Latitude for inclusive geo-search. coordinate_longitude: Longitude for inclusive geo-search. coordinate_distance: Radius in meters for inclusive geo-search (default 100). coordinate_latitude_exclusive: Latitude for exclusive geo-search. coordinate_longitude_exclusive: Longitude for exclusive geo-search. coordinate_distance_exclusive: Radius in meters for exclusive geo-search. phone_number: Phone numbers to include. phone_number_exclusive: Phone numbers to exclude. email: Email addresses to include. email_exclusive: Email addresses to exclude. website: Website URLs to include. website_exclusive: Website URLs to exclude. website_ip_address: Filter by website IP address. international_codes: ISIC international category codes to include. international_codes_exclusive: ISIC codes to exclude. infobel_codes: Infobel proprietary category codes to include. infobel_codes_exclusive: Infobel codes to exclude. local_codes: Local/national category codes to include (e.g. SIC, NAF). local_codes_exclusive: Local codes to exclude. alt_international_codes: NACE category codes to include. alt_international_codes_exclusive: NACE codes to exclude. categories_keywords: Free-text category keywords. restrict_on_main_category: When True, match only the primary category. has_address: Filter for businesses with an address. has_phone: Filter for businesses with phone numbers. has_fax: Filter for businesses with fax numbers. has_mobile: Filter for businesses with mobile numbers. has_email: Filter for businesses with email addresses. has_website: PresenceType for website: 0=Ignore, 1=Has, 2=HasNot. has_national_id: PresenceType for national ID: 0=Ignore, 1=Has, 2=HasNot. has_web_contact: Filter for businesses with website or email. has_contact: Filter for businesses with phone or mobile. has_coordinates: Filter for businesses with GPS coordinates. has_linked_in: Filter for businesses with LinkedIn profiles. has_logo: Filter for businesses with logos. has_admin: Filter for businesses with admin data. has_marketability: Filter for marketable records. has_building_geometry: Filter for records with building geometry. has_shop_tool: Filter for businesses with shop tools. has_payment: Filter for businesses with payment capabilities. has_digital_marketing: Filter for businesses with digital marketing. has_e_shop: Filter for businesses with e-shops. has_phone_deduplicated: Deduplicate on phone (requires has_phone). has_email_deduplicated: Deduplicate on email (requires has_email). has_website_deduplicated: Deduplicate on website (requires has_website). has_web_domain_deduplicated: Deduplicate on domain (requires has_website). has_national_id_deduplicated: Deduplicate on national ID. has_mobile_deduplicated: Deduplicate on mobile. has_contact_deduplicated: Deduplicate on contact. year_started_from: Minimum year started (e.g. "2000"). year_started_to: Maximum year started (e.g. "2020"). employees_total_from: Minimum employee count. employees_total_to: Maximum employee count. sales_volume_from: Minimum sales volume. sales_volume_to: Maximum sales volume. sales_volume_currency: Currency for sales volume (use get_currencies for codes). sales_volum_reliability_codes: Sales reliability codes to include. sales_volum_reliability_codes_exclusive: Sales reliability codes to exclude. family_members_from: Minimum family member count. family_members_to: Maximum family member count. is_published: Filter by published status on infobel.com. is_vat: Filter where NationalID is also a VAT number. filter_on_dncm: Exclude DoNotCallMe records (Belgium only). publishing_strength_from: Minimum publishing strength (0+). publishing_strength_to: Maximum publishing strength (max 100). linked_in_followers_from: Minimum LinkedIn followers. linked_in_followers_to: Maximum LinkedIn followers. status_codes: Business status codes for corporate hierarchy filtering. Use ["0"] for single-location independent companies (no corporate linkage — no parent, no subsidiaries). Use ["1"] for headquarters (HQ) of a corporate group. Use ["2"] for branches of a larger company. IMPORTANT: When searching for independent companies with no corporate linkage or subsidiaries, always include the appropriate status_codes to avoid returning corporate subsidiaries or branch offices. Choose based on the use case: - Fully independent single site → status_codes=["0"] - Group HQ only → status_codes=["1"] - Branch offices only → status_codes=["2"] - All with no parent filter → status_codes=["0","1","2"] Use get_status_codes to retrieve the full list. status_codes_exclusive: Business status codes to exclude. geo_levels: Geographic precision levels to include (use get_geo_levels). geo_levels_exclusive: Geographic precision levels to exclude. parent_unique_id: Filter by parent company unique ID. parent_unique_id_exclusive: Parent unique IDs to exclude. global_ultimate_unique_id: Filter by global ultimate owner unique ID. global_ultimate_unique_id_exclusive: Global ultimate unique IDs to exclude. global_ultimate_country_codes: Filter by global ultimate country codes. global_ultimate_country_codes_exclusive: Global ultimate country codes to exclude. domestic_ultimate_unique_id: Filter by domestic ultimate owner unique ID. domestic_ultimate_unique_id_exclusive: Domestic ultimate unique IDs to exclude. ceo_name: CEO/executive name search. ceo_title: CEO/executive title search. executive_tags: Filter by executive tags (use get_executive_tags for values). legal_status_codes: Legal form codes to include (use get_legal_status_codes). legal_status_codes_exclusive: Legal form codes to exclude. national_identification_type_codes: National ID type codes to include. national_identification_type_codes_exclusive: National ID type codes to exclude. import_export_agent_codes: Import/export agent codes to include. import_export_agent_codes_exclusive: Import/export agent codes to exclude. technographical_tags: Filter by web technologies (use get_technographical_tags). website_status_flags: Website status flags to include (use get_website_status_flags). website_status_flags_exclusive: Website status flags to exclude. social_links: Social media platforms to include (use get_social_links for codes). social_links_exclusive: Social media platforms to exclude. languages: ISO 639-3 language codes to include. languages_exclusive: ISO 639-3 language codes to exclude. can_match_any_business_filter: When True, OR logic instead of AND. try_any_location_match: Use partial location matches if exact not found. international_phone_format: Return phone numbers with +xxx prefix. validate_filters: Validate provided filters before searching. display_language: Language for result display (e.g. "en", "fr"). page_size: Results per page (default 20). sorting_order: Sorting options (use get_sorting_orders for values). data_type: Data type: "Business" (default), "YellowPages", or "WhitePages".

Get paginated results from a previous search.

IMPORTANT — record_fields is required. Pass the same field list you used in search_businesses to get consistent, context-efficient results. uniqueID is always included automatically.

Args: search_id: Search ID returned by search_businesses. page: Page number (1-indexed). Pages must be fetched sequentially. record_fields: Fields to return per record. Must be non-empty. uniqueID is always included automatically.

Check the status of a previous search.

Args: search_id: Search ID returned by search_businesses.

Get the full record for a business by country code and unique ID.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "GB"). unique_id: Infobel unique ID for the business.

Get a partial (lighter) record for a business.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "GB"). unique_id: Infobel unique ID for the business.

Search Infobel's proprietary category hierarchy by one or more keywords.

Each keyword triggers a separate API call; results are merged and deduplicated. Use multiple keywords to widen coverage — e.g. ["plumbing", "plumber", "pipes"]. Returns matching categories with their codes for use in search_businesses infobel_codes field.

Args: keywords: One or more search terms (e.g. ["restaurant"], ["computer", "software", "IT"]). language_code: Display language for results (e.g. "en", "fr", "de").

Search ISIC international category codes (UN standard) by one or more keywords.

Each keyword triggers a separate API call; results are merged and deduplicated. Returns matching codes for use in search_businesses international_codes field. Use for cross-country industry searches using UN classification.

Args: keywords: One or more search terms (e.g. ["manufacturing"], ["retail", "wholesale", "trade"]). language_code: Display language for results (e.g. "en", "fr").

Search country-specific category codes by one or more keywords.

Each keyword triggers a separate API call; results are merged and deduplicated. Returns matching local codes (e.g. SIC for US, NAF for France, WZ for Germany) for use in search_businesses local_codes field.

Args: keywords: One or more search terms (e.g. ["plomberie"], ["bakery", "boulangerie", "pastry"]). country_code: ISO 3166-1 alpha-2 country code (e.g. "FR", "DE", "US"). language_code: Display language for results (e.g. "en", "fr").

Search NACE codes (European standard, AltInternational) by one or more keywords.

Each keyword triggers a separate API call; results are merged and deduplicated. Returns matching NACE codes for use in search_businesses alt_international_codes field. Use this for EU industry classification queries.

Args: keywords: One or more search terms (e.g. ["computer programming"], ["software", "IT", "development"]). language_code: Display language for results (e.g. "en", "fr", "de").

List all regions for a country. Use the returned codes as region_code in get_provinces.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "GB", "DE"). language_code: Display language for results (e.g. "en", "de", "fr").

List provinces for a country, optionally filtered by region code.

Use the returned codes as province_code in get_cities or search_businesses.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "GB", "DE"). region_code: Optional region code from get_regions to narrow results. language_code: Display language for results (e.g. "en", "de", "fr").

Search cities within a country by keyword.

Use the returned codes as city_codes in search_businesses filters. Always provide a specific city name or partial name — never call without a keyword.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). keyword: City name or partial name to search for (e.g. "New York", "Munich"). province_code: Optional province code to narrow results to a specific province/state. language_code: Display language for results (e.g. "en", "de", "fr").

Search cities, regions, and provinces within a country by one or more keywords.

Each keyword triggers a separate API call; results are merged and deduplicated. Returns matching location codes for use in search_businesses filters (city_codes, region_codes, province_codes). Always use this instead of fetching full location lists.

Args: keywords: One or more search terms (e.g. ["Munich"], ["Bavaria", "Bayern", "Munich"]). country_code: ISO 3166-1 alpha-2 country code (e.g. "DE", "GB"). language_code: Display language for results (e.g. "en", "de", "fr").

List all countries available in the Infobel database.

List available display languages for API results.

List reliability codes and their meanings.

List business status / hierarchy codes and their meanings.

Returns the BusinessStatusCode enum values used in the search_businesses status_codes and status_codes_exclusive filters. Values indicate the physical location type: SingleLocation (0), HQ (1), Branch (2).

List geographic precision levels used in the geo_levels search filter.

Returns codes and descriptions indicating the geocoding accuracy of a record (e.g. address-level, city-level, country-level).

List supported currencies for the sales_volume_currency search filter.

Returns currency codes such as Local (0), USD (1), EUR (2).

List available sorting order options for the sorting_order search parameter.

List website status flags used in the website_status_flags search filter.

Returns integer codes and descriptions indicating the crawl/availability status of a business website.

List supported social media platforms for the social_links search filter.

Returns platform codes (e.g. "linkedin", "facebook") to use when filtering businesses by social media presence.

List import/export agent codes for the import_export_agent_codes search filter.

List legal status codes (business legal forms) for a country.

Use the returned codes in the search_businesses legal_status_codes and legal_status_codes_exclusive filters.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "BE", "DE", "FR"). keyword: Optional keyword to filter results (e.g. "SA", "GmbH", "Ltd").

List national identification type codes for a country.

Use the returned codes in the search_businesses national_identification_type_codes filter.

Args: country_code: ISO 3166-1 alpha-2 country code (e.g. "BE", "GB", "US").

List technographic tags for the technographical_tags search filter.

Technographic tags identify web technologies used by a business (e.g. specific CMS, e-commerce platforms, analytics tools).

Args: keyword: Optional keyword to filter results (e.g. "shopify", "wordpress").

List executive tags for the executive_tags search filter.

Executive tags describe attributes or roles of business executives.

Args: keyword: Optional keyword to filter results (e.g. "ceo", "founder").

Verify API connectivity and authentication.