Help Center

How to get statistical data about businesses in a certain category?

Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category. You will also get statistical data on the top services that are available and top place topics.

To make a request you should specify the categories of business listing. You may also add a location, initial_dataset_filters, and other parameters to sort the results.

For example, you’re planning to open a new fitness club in London and want to get general information about the fitness market in the UK. For the request you can use the following categories: "fitness_center", "physical_fitness_program", "sports_club".

To get a full list of available categories make a request to the Business Listings Categories endpoint.

If you want to get business listings with high ratings, you can use ["rating.value",">=",4] filter.

Example of the request:

[
  {
    "categories": [
      "fitness_center"
    ],
    "is_claimed": true,
    "location_name": "United Kingdom",
    "initial_dataset_filters": [
      ["rating.value",">=",4]
    ],
    "limit": 3
  }
]

In the API response you will get the statistical data on high-rated businesses in the “fitness_center” and related categories:

{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.4378 sec.",
  "cost": 0.0109,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "05190306-1535-0545-0000-b8aacbdc2b08",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.3756 sec.",
      "cost": 0.0109,
      "result_count": 1,
      "path": [
        "v3",
        "business_data",
        "business_listings",
        "categories_aggregation",
        "live"
      ],
      "data": {
        "api": "business_data",
        "function": "categories_aggregation",
        "categories": [
          "fitness_center"
        ],
        "is_claimed": true,
        "initial_dataset_filters": [
          [
            "rating.value",
            ">=",
            4
          ]
        ],
        "limit": 3
      },
      "result": [
        {
          "total_count": 1552,
          "count": 3,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": "business_category",
              "categoiries": [
                "fitness_center"
              ],
              "aggregation": {
                "top_categories": {
                  "fitness_center": 92433,
                  "gym": 35148,
                  "personal_trainer": 20901,
                  "physical_fitness_program": 17837,
                  "yoga_studio": 5812,
                  "weight_loss_service": 5305,
                  "pilates_studio": 4533,
                  "nutritionist": 4090,
                  "martial_arts_school": 3187,
                  "boxing_gym": 2939
                },
                "top_countries": {
                  "US": 24379,
                  "BR": 11800,
                  "IN": 7596,
                  "DE": 7159,
                  "IT": 6551,
                  "GB": 4798,
                  "AU": 4611,
                  "FR": 3793,
                  "ES": 2839,
                  "CA": 2836
                },
                "websites_count": 43850,
                "count": 92433,
                "top_attributes": {
                  "has_wheelchair_accessible_parking": 54009,
                  "has_wheelchair_accessible_entrance": 52231,
                  "has_onsite_services": 27293,
                  "welcomes_children": 17946,
                  "offers_online_classes": 15014,
                  "requires_appointments": 12780,
                  "has_wheelchair_accessible_restroom": 9414,
                  "is_owned_by_women": 9111,
                  "requires_membership": 8984,
                  "has_restroom": 8532
                },
                "top_place_topics": {
                  "equipment": 11613,
                  "environment": 10152,
                  "coaches": 9473,
                  "team": 8011,
                  "atmosphere": 7418,
                  "price": 6844,
                  "feel": 6520,
                  "goals": 6271,
                  "trainers": 4713,
                  "community": 4414
                }
              }
            },
            {
              "type": "business_category",
              "categoiries": [
                "gym"
              ],
              "aggregation": {
                "top_categories": {
                  "fitness_center": 35148,
                  "gym": 35148,
                  "personal_trainer": 13942,
                  "physical_fitness_program": 13267,
                  "weight_loss_service": 3383,
                  "yoga_studio": 2851,
                  "weightlifting_area": 2051,
                  "spa_and_health_club": 1883,
                  "boxing_gym": 1857,
                  "nutritionist": 1857
                },
                "top_countries": {
                  "US": 15208,
                  "IN": 2542,
                  "GB": 2385,
                  "AU": 2373,
                  "FR": 1805,
                  "JP": 1329,
                  "DE": 1130,
                  "CA": 1099,
                  "BR": 984,
                  "IT": 834
                },
                "websites_count": 14519,
                "count": 35148,
                "top_attributes": {
                  "has_wheelchair_accessible_parking": 24533,
                  "has_wheelchair_accessible_entrance": 23554,
                  "has_onsite_services": 11251,
                  "offers_online_classes": 6996,
                  "requires_appointments": 4081,
                  "is_owned_by_women": 3871,
                  "has_wheelchair_accessible_restroom": 3864,
                  "requires_membership": 3692,
                  "welcomes_lgbtq": 3106,
                  "welcomes_children": 3091
                },
                "top_place_topics": {
                  "equipment": 8455,
                  "coaches": 4439,
                  "environment": 4386,
                  "feel": 4262,
                  "atmosphere": 4128,
                  "goals": 4087,
                  "trainers": 3368,
                  "clean": 3344,
                  "team": 3244,
                  "price": 3229
                }
              }
            },
            {
              "type": "business_category",
              "categoiries": [
                "personal_trainer"
              ],
              "aggregation": {
                "top_categories": {
                  "fitness_center": 20901,
                  "personal_trainer": 20901,
                  "gym": 13942,
                  "physical_fitness_program": 10427,
                  "weight_loss_service": 3277,
                  "nutritionist": 2623,
                  "yoga_studio": 1792,
                  "womens_personal_trainer": 1763,
                  "weightlifting_area": 1666,
                  "pilates_studio": 1485
                },
                "top_countries": {
                  "US": 9521,
                  "AU": 1671,
                  "GB": 1600,
                  "DE": 1258,
                  "CA": 927,
                  "FR": 793,
                  "IN": 749,
                  "IT": 687,
                  "BR": 657,
                  "ES": 419
                },
                "websites_count": 11789,
                "count": 20901,
                "top_attributes": {
                  "has_wheelchair_accessible_parking": 14964,
                  "has_wheelchair_accessible_entrance": 14149,
                  "has_onsite_services": 7875,
                  "offers_online_classes": 4870,
                  "has_restroom": 4849,
                  "requires_appointments": 4191,
                  "has_wheelchair_accessible_restroom": 3268,
                  "welcomes_lgbtq": 2647,
                  "has_outdoor_services": 2274,
                  "is_owned_by_women": 2126
                },
                "top_place_topics": {
                  "equipment": 4842,
                  "goals": 3690,
                  "feel": 2682,
                  "environment": 2478,
                  "atmosphere": 2361,
                  "coaches": 2336,
                  "team": 2263,
                  "trainers": 2013,
                  "community": 1750,
                  "clean": 1736
                }
              }
            }
          ]
        }
      ]
    }
  ]
}