DataForSEO icon

DataForSEO

DataForSEO

Business Data → Get Business Listings

AI-generated

Summary

Get a list of business listings from Google Maps filtered by specified categories, description, title, claimed status, location coordinate, and additional filters, with sorting, pagination controls and limits on result count.

Inputs

  • Categories — Up to 10 business categories to filter the listings.
  • Description — Text description filter for the business listings (up to 200 characters).
  • Title — Text title filter for the business listings (up to 200 characters).
  • Is Claimed — Filter listings by claimed status: Yes, No, or leave blank for all.
  • Location Coordinate — Location specified as latitude,longitude,radius (e.g., 53.476225,-2.243572,200), with constraints on decimal precision and radius size.
  • Filters — JSON array string of additional filtering parameters as documented by DataForSEO.
  • Sort — Up to three sorting rules specifying fields and direction to order results.
  • Limit — Maximum number of results to return (up to 1000, default 50).
  • Offset — Number of results to skip for pagination (default 0).

Output shape

a JSON object containing search results from the DataForSEO API representing business listings matching the specified criteria.

The operation returns the results as JSON with pagination support governed by limit and offset parameters. Filters and sorting rules must conform to DataForSEO specifications. The maximum number of categories is 10, and sorting rules is 3.

Examples

Example 1: Retrieve up to 100 businesses in specified categories near a location, sorted by rating descending

Set Categories to desired business categories, provide Location Coordinate, set Sort to Rating Value Descending, and Limit to 100.

Links

Discussion