search_businesses

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 total employee count (whole company). employees_total_to: Maximum total employee count (whole company). employees_here_from: Minimum employee count at this location. employees_here_to: Maximum employee count at this location. 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".