Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Businesses

Get completion rate stats from your businesses

This endpoint works in the same way as the operation/searchBusinesses endpoint, but instead of returning data on all returned businesses, this endpoint returns completion rate statistics aggregated across all businesses.

The statistics returned are the average completion rate for all businesses that fit the given filters, as well as the count of businesses with a low, medium, and high respectively. The thresholds for low, medium, and high can be found below in the response details.

Note that this endpoint works in the exact same way as operation/searchBusinesses (with the exception of parameters that format the output, such as order_by and pagination), but the return value is different.

get/business/search/stats

Query parameters

querystring

Parameter to fuzzy search businesses on city, zipcode and name

business__inBusinessId[]

Filter by business ids. Use a comma-separated list to provide multiple ids.

[
  "5409c35a97bbc544d8e26737"
]
org_idinteger

Filter by organization ID. Only PROVIDER users can use this filter. If you are not a PROVIDER, this will default to the ID of your organization.

groupsinteger[]

Filter by groups, using the access logic with the and/or depending on the groups sections

See the Groups and Sections description

countrystring

Filter by country - ISO 3166 alpha2 code (i.e. “FR” for France)

namestring

Filter by name

status'open' | 'closed' | 'opening_soon' | 'closed_temporarily'

Defines the current status of the business.

  • Open indicates the business is up and running.
  • Closed means that the business has definitely closed.
  • Opening Soon indicates the business is open with an opening date set in the future.
  • Temporarily closed means that the business is temporarily closed.

⚠️ To get all businesses with the status open, regardless of whether the opening_date has passed yet or not, submit both the open and opening_soon options in the filter: status=open,opening_soon.

Example:open
zipcodestring

Filter by zipcode

citystring

Filter by city

codestring

Filter by code

modified__gtenumber

Filter by modified attribute (modified >= modified_gte)

features__in'diffusion' | 'feedback_management' | 'messages' | 'posts' | 'review_invite' | 'review_management'
features__notin'diffusion' | 'feedback_management' | 'messages' | 'posts' | 'review_invite' | 'review_management'
subscribed_to_rmboolean

Filter by current subscription to review_management.

  • If true, only businesses subscribed to review_management will be included.
  • If false, only businesses not subscribed to review_management will be included.

Equivalent to using features__in=review_management.

subscribed_to_pmboolean

Filter by current subscription to presence_management.

  • If true, only businesses subscribed to presence_management will be included.
  • If false, only businesses not subscribed to presence_management will be included.

Equivalent to using features__in=diffusion.

subscribed_to_rbboolean

Filter by current subscription to review_booster.

  • If true, only businesses subscribed to review_booster will be included.
  • If false, only businesses not subscribed to review_booster will be included.

Equivalent to using features__in=review_invite.

subscribed_to_bmboolean

Filter by current subscription to messages.

  • If true, only businesses subscribed to messages will be included.
  • If false, only businesses not subscribed to messages will be included.

Equivalent to using features__in=messages.

completion_rate__gteinteger

Filter by completion_rate attribute (completion_rate >= completion_rate__gte)

completion_rate__lteinteger

Filter by completion_rate attribute (completion_rate <= completion_rate__lte)

completion_rate'low' | 'mid' | 'high'
Example:low,mid

Filter by completion_rate attribute. You can separate the values by a comma, as done in the example.

has_promoboolean
  • If true, include only businesses having promotional offers.
  • If false, include only businesses not having any promotional offer.
connected_to_gmb_locationboolean
  • If true, only businesses currently linked to a Google location will be included.
  • If false, only businesses not linked to any Google location will be included.
connected_to_facebook_locationboolean
  • If true, only businesses currently linked to a Facebook location will be included.
  • If false, only businesses not linked to any Facebook location will be included.

Response

OK

average_completion_rateinteger

The average completion rate of all businesses that fit the filters given in paramers.

Example response

{
  "average_completion_rate": 72,
  "counts": {
    "low": 2,
    "mid": 10,
    "high": 22
  }
}