Skip to content
Eden Engine

Category Leaders & Top-Ranked Software (By Category)

omnial/get-category-leaders

Given a software category's URL slug, returns the ranked page of top products for that category -- name, tagline, description, rating and review-count breakdown, popular feature tags, and a flag for whether each product is a marked category leader -- alongside the category's own filter facets (features, integrations, OS, pricing tier, customer segment, star rating), sort options, pagination totals, related categories to explore, and a short buyer's-guide title for the category. Returns an empty result when the category_slug does not match a listed category.

activeper callv2
Provider
Web & Business Data Network
Category
software-reviews
Provider price
$0.01365 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "required": [
    "category_slug"
  ],
  "properties": {
    "category_slug": {
      "type": "string",
      "description": "Category URL path segment without leading/trailing slashes (e.g. 'customer-management-software/crm'). Same format as list_software_by_category."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "serpData": {
          "type": "object",
          "properties": {
            "facets": {
              "type": "object",
              "properties": {
                "oses_facet": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "selected": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Operating-system filter options."
                },
                "rating_stars_ge": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "A string label (e.g. 'All Reviews') on the unfiltered option; typically null on every star-threshold option."
                      },
                      "value": {
                        "type": [
                          "string",
                          "number"
                        ],
                        "description": "The string 'all' for the unfiltered option; a number (e.g. 4, 3, 2) for each star-threshold option."
                      },
                      "selected": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Minimum-star-rating filter options."
                },
                "feature_tags_facet": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "selected": {
                        "type": "boolean"
                      },
                      "global_product_id": {
                        "type": "string",
                        "description": "Opaque filter id."
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Feature-tag filter options. Carries `global_product_id` (feature-tags and integrations only)."
                },
                "typecustomers_facet": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "selected": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Customer-segment filter options."
                },
                "integrated_with_facet": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "selected": {
                        "type": "boolean"
                      },
                      "global_product_id": {
                        "type": "string",
                        "description": "Opaque filter id."
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Integration filter options. Carries `global_product_id` (feature-tags and integrations only)."
                },
                "pricingcategories_facet": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "href": {
                        "type": "string",
                        "description": "Opaque relative filter-query fragment, not a full URL."
                      },
                      "count": {
                        "type": [
                          "number",
                          "null"
                        ],
                        "description": "Observed as null on every facet entry in testing."
                      },
                      "label": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "selected": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Pricing-tier filter options."
                }
              },
              "description": "Filter options available for this category, e.g. six groups: feature_tags_facet, integrated_with_facet, oses_facet, pricingcategories_facet, rating_stars_ge, typecustomers_facet.",
              "additionalProperties": true
            },
            "category": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "Relative path to the category's page on the source site."
                },
                "name": {
                  "type": "string",
                  "description": "Category display name, e.g. 'CRM'."
                },
                "slug": {
                  "type": "string"
                },
                "cta_urls": {
                  "type": "object",
                  "properties": {
                    "detail": {
                      "type": "string",
                      "description": "Relative path to the category's detail page."
                    }
                  },
                  "additionalProperties": true
                },
                "last_updated_on": {
                  "type": "string",
                  "description": "ISO 8601 timestamp."
                },
                "selected_feature": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "e.g. 'Activity Dashboard'."
                    },
                    "slug": {
                      "type": "string"
                    },
                    "definition": {
                      "type": "string"
                    }
                  },
                  "description": "A single highlighted feature for this category. Typically populated (non-null); behavior for a category with no highlighted feature is not documented.",
                  "additionalProperties": true
                },
                "global_category_id": {
                  "type": "string",
                  "description": "The category's opaque id."
                }
              },
              "description": "The category the listings belong to.",
              "additionalProperties": true
            },
            "listings": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Relative path to the product's page on the source site."
                  },
                  "name": {
                    "type": "string",
                    "description": "Product name."
                  },
                  "slug": {
                    "type": "string"
                  },
                  "reviews": {
                    "type": "object",
                    "properties": {
                      "total": {
                        "type": "number"
                      },
                      "by_field": {
                        "type": "object",
                        "properties": {
                          "rating_ease": {
                            "type": "string"
                          },
                          "rating_value": {
                            "type": "string"
                          },
                          "rating_support": {
                            "type": "string"
                          },
                          "rating_features": {
                            "type": "string"
                          },
                          "likelihood_to_recommend": {
                            "type": "string"
                          }
                        },
                        "description": "Per-category average scores as NUMERIC-LOOKING STRINGS (e.g. \"4.29\"), not numbers.",
                        "additionalProperties": true
                      },
                      "by_rating": {
                        "type": "object",
                        "properties": {
                          "1": {
                            "type": "number"
                          },
                          "2": {
                            "type": "number"
                          },
                          "3": {
                            "type": "number"
                          },
                          "4": {
                            "type": "number"
                          },
                          "5": {
                            "type": "number"
                          }
                        },
                        "description": "Count of reviews at each star level, keys '1'-'5'.",
                        "additionalProperties": true
                      }
                    },
                    "additionalProperties": true
                  },
                  "tagline": {
                    "type": "string"
                  },
                  "cta_urls": {
                    "type": "object",
                    "properties": {
                      "detail": {
                        "type": "string",
                        "description": "Relative path to the product's detail page."
                      },
                      "reviews": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Observed as null on every listing in testing."
                      },
                      "features": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Observed as null on every listing in testing."
                      },
                      "sem_detail": {
                        "type": "string"
                      },
                      "spotlight_pricing": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Observed as null on every listing in testing."
                      }
                    },
                    "additionalProperties": true
                  },
                  "features": {
                    "type": "object",
                    "properties": {
                      "popular": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "slug": {
                              "type": "string",
                              "description": "Opaque feature id, not a URL slug."
                            }
                          },
                          "additionalProperties": true
                        },
                        "description": "Up to 10 popular feature tags per listing."
                      }
                    },
                    "additionalProperties": true
                  },
                  "is_premium": {
                    "type": "boolean"
                  },
                  "rating_avg": {
                    "type": "number",
                    "description": "Overall average rating, out of 5."
                  },
                  "description": {
                    "type": "string"
                  },
                  "num_reviews": {
                    "type": "number"
                  },
                  "most_visited": {
                    "type": "boolean",
                    "description": "Usually false on every listing."
                  },
                  "global_product_id": {
                    "type": "string",
                    "description": "The product's opaque id."
                  },
                  "is_category_leader": {
                    "type": "boolean",
                    "description": "Usually false on every listing; a marked category leader (true) is not documented."
                  },
                  "category_leaders_score": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Observed as null on every listing in testing."
                  }
                },
                "additionalProperties": true
              },
              "description": "The ranked page of software products for this category."
            },
            "pagination": {
              "type": "object",
              "properties": {
                "page": {
                  "type": "number",
                  "description": "Always 1 -- this endpoint has no page input."
                },
                "num_items": {
                  "type": "number",
                  "description": "Total matching products across all pages."
                },
                "num_pages": {
                  "type": "number",
                  "description": "Total number of pages at the current page size."
                },
                "first_page": {
                  "type": "string",
                  "description": "Relative path to the first page on the source site."
                },
                "items_per_page": {
                  "type": "number"
                },
                "other_page_pattern": {
                  "type": "string",
                  "description": "Relative path template for subsequent pages, e.g. contains 'PAGE'."
                }
              },
              "additionalProperties": true
            },
            "sorting_options": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Relative path with the sort applied."
                  },
                  "slug": {
                    "type": "string",
                    "description": "e.g. 'relevance', 'reviews'."
                  },
                  "label": {
                    "type": "string"
                  },
                  "selected": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": true
              },
              "description": "The sort orders offered for this category's listings."
            },
            "topRatedProducts": {
              "type": "array",
              "items": {},
              "description": "Usually empty; the shape of a populated entry is not documented."
            },
            "related_categories": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "e.g. 'Contact Management'."
                  },
                  "slug": {
                    "type": "string"
                  },
                  "cta_urls": {
                    "type": "object",
                    "properties": {
                      "detail": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  },
                  "listings": {
                    "type": "array",
                    "items": {},
                    "description": "Usually empty on every related category; the shape of a populated entry is not documented."
                  },
                  "num_listings": {
                    "type": "number"
                  },
                  "global_category_id": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "description": "Other categories related to this one."
            },
            "topFeaturedProducts": {
              "type": "array",
              "items": {},
              "description": "Usually empty; the shape of a populated entry is not documented."
            }
          },
          "additionalProperties": true
        },
        "buyersGuide": {
          "type": "object",
          "properties": {
            "slug": {
              "type": "string"
            },
            "title": {
              "type": "string",
              "description": "e.g. 'CRM'."
            }
          },
          "description": "The category's buyer's-guide title and slug. The guide's full prose content is a deeply nested, variably-shaped rich-text document in the raw response and is not carried through.",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on the one found-category call observed."
    }
  },
  "description": "The category-leaders page. Returned as an empty object `{}` when the given `category_slug` does not resolve to a listed category.",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.01365
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Oct 12, 2026