DataForSEO — Business Data / Business Listings / Categories Aggregation / Live
Retrieve business Data Business Listings Categories Aggregation Live with the DataForSEO API. The sample response includes titles. Use it for account research or company due diligence.
- Selected price
- $0.012 base + $0.00036 / result Published pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
DataForSEOCurrent DataForSEO — Business Data / Business Listings / Categories Aggregation / Live · POST | $0.012 base + $0.00036 / result | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
costnumberstatus_codeintegerstatus_messagestringtasksobject[]costnumberdataobjectapistringcategoriesstring[]descriptionstringfunctionstringinitial_dataset_filters((string | integer)[])[]is_claimedbooleanlimitintegerlocation_coordinatestringtitlestring
idstringpathstring[]resultobject[]countintegeritemsobject[]aggregationobjectcountintegertop_attributesobjectaccepts_reservationsintegerfeels_casualintegerhas_deliveryintegerhas_no_contact_deliveryintegerhas_takeoutintegerhas_wheelchair_accessible_entranceintegerpay_debit_cardintegerpay_mobile_nfcintegerserves_dessertintegerserves_dinnerintegeris_transgender_safespaceintegerserves_late_night_foodinteger
top_categoriesobjectdelivery_serviceintegerfast_food_restaurantintegeritalian_restaurantintegermeal_takeawayintegerneapolitan_restaurantintegerpizza_delivery_serviceintegerpizza_restaurantintegerpizzatakeawayintegerrestaurantintegervegan_restaurantintegerbuffet_restaurantintegerfamily_restaurantinteger
top_countriesobjectGBinteger
top_place_topicsobjectatmosphereintegercoldintegerdominosintegerdoughintegerkidsintegermoneyintegerorderintegerphoneintegerpriceintegerveganintegerappintegerbuffetintegercallintegerice creamintegerpayintegerthe pizzaintegerincredible pizzainteger
websites_countinteger
categoiriesstring[]typestring
offsetnulloffset_tokennulltotal_countinteger
result_countintegerstatus_codeintegerstatus_messagestringtimestring
tasks_countintegertasks_errorintegertimestringversionstring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
cost?: number;
status_code?: number;
status_message?: string;
tasks?: Array<{
cost?: number;
data?: {
api?: string;
categories?: Array<string>;
description?: string;
function?: string;
initial_dataset_filters?: Array<Array<string | number>>;
is_claimed?: boolean;
limit?: number;
location_coordinate?: string;
title?: string;
};
id?: string;
path?: Array<string>;
result?: Array<{
count?: number;
items?: Array<{
aggregation?: {
count?: number;
top_attributes?: {
accepts_reservations?: number;
feels_casual?: number;
has_delivery?: number;
has_no_contact_delivery?: number;
has_takeout?: number;
has_wheelchair_accessible_entrance?: number;
pay_debit_card?: number;
pay_mobile_nfc?: number;
serves_dessert?: number;
serves_dinner?: number;
is_transgender_safespace?: number;
serves_late_night_food?: number;
};
top_categories?: {
delivery_service?: number;
fast_food_restaurant?: number;
italian_restaurant?: number;
meal_takeaway?: number;
neapolitan_restaurant?: number;
pizza_delivery_service?: number;
pizza_restaurant?: number;
pizzatakeaway?: number;
restaurant?: number;
vegan_restaurant?: number;
buffet_restaurant?: number;
family_restaurant?: number;
};
top_countries?: {
GB?: number;
};
top_place_topics?: {
atmosphere?: number;
cold?: number;
dominos?: number;
dough?: number;
kids?: number;
money?: number;
order?: number;
phone?: number;
price?: number;
vegan?: number;
app?: number;
buffet?: number;
call?: number;
"ice cream"?: number;
pay?: number;
"the pizza"?: number;
"incredible pizza"?: number;
};
websites_count?: number;
};
categoiries?: Array<string>;
type?: string;
}>;
offset?: null;
offset_token?: null;
total_count?: number;
}>;
result_count?: number;
status_code?: number;
status_message?: string;
time?: string;
}>;
tasks_count?: number;
tasks_error?: number;
time?: string;
version?: string;
};- Method
- POST
- Endpoint
https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
}
]'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
body | JSON request bodybody | array | Yes | Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category. The provided results are specific to the specified parameters. minItems: 1 · maxItems: 1 Nested fields and variants
Nested fields and variants
|
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Configured HTTP 200; actual status is unverified. Example from the provider's documentation. Field values in your results will differ.
{
"cost": 0.0109,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.0109,
"data": {
"api": "business_data",
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"function": "categories_aggregation",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
},
"id": "04301510-1535-0545-0000-92269c6091b9",
"path": [
"v3",
"business_data",
"business_listings",
"categories_aggregation",
"live"
],
"result": [
{
"count": 3,
"items": [
{
"aggregation": {
"count": 32,
"top_attributes": {
"accepts_reservations": 17,
"feels_casual": 28,
"has_delivery": 32,
"has_no_contact_delivery": 20,
"has_takeout": 32,
"has_wheelchair_accessible_entrance": 17,
"pay_debit_card": 26,
"pay_mobile_nfc": 23,
"serves_dessert": 20,
"serves_dinner": 18
},
"top_categories": {
"delivery_service": 7,
"fast_food_restaurant": 4,
"italian_restaurant": 7,
"meal_takeaway": 3,
"neapolitan_restaurant": 6,
"pizza_delivery_service": 11,
"pizza_restaurant": 32,
"pizzatakeaway": 14,
"restaurant": 12,
"vegan_restaurant": 3
},
"top_countries": {
"GB": 32
},
"top_place_topics": {
"atmosphere": 6,
"cold": 5,
"dominos": 6,
"dough": 4,
"kids": 5,
"money": 7,
"order": 8,
"phone": 5,
"price": 9,
"vegan": 6
},
"websites_count": 18
},
"categoiries": [
"pizza_restaurant"
],
"type": "business_category"
},
{
"aggregation": {
"count": 14,
"top_attributes": {
"accepts_reservations": 9,
"feels_casual": 13,
"has_delivery": 14,
"has_no_contact_delivery": 10,
"has_takeout": 14,
"is_transgender_safespace": 9,
"pay_debit_card": 12,
"pay_mobile_nfc": 12,
"serves_dessert": 9,
"serves_late_night_food": 8
},
"top_categories": {
"buffet_restaurant": 1,
"family_restaurant": 2,
"fast_food_restaurant": 3,
"italian_restaurant": 2,
"meal_takeaway": 2,
"pizza_delivery_service": 8,
"pizza_restaurant": 14,
"pizzatakeaway": 14,
"restaurant": 8,
"vegan_restaurant": 2
},
"top_countries": {
"GB": 14
},
"top_place_topics": {
"app": 2,
"buffet": 3,
"call": 2,
"ice cream": 3,
"kids": 3,
"money": 3,
"order": 4,
"pay": 3,
"price": 5,
"the pizza": 3
},
"websites_count": 7
},
"categoiries": [
"pizzatakeaway"
],
"type": "business_category"
},
{
"aggregation": {
"count": 12,
"top_attributes": {
"accepts_reservations": 11,
"feels_casual": 11,
"has_delivery": 12,
"has_no_contact_delivery": 8,
"has_takeout": 12,
"has_wheelchair_accessible_entrance": 8,
"is_transgender_safespace": 11,
"pay_debit_card": 11,
"pay_mobile_nfc": 11,
"serves_dessert": 10
},
"top_categories": {
"buffet_restaurant": 1,
"delivery_service": 1,
"family_restaurant": 2,
"italian_restaurant": 3,
"neapolitan_restaurant": 3,
"pizza_delivery_service": 5,
"pizza_restaurant": 12,
"pizzatakeaway": 8,
"restaurant": 12,
"vegan_restaurant": 2
},
"top_countries": {
"GB": 12
},
"top_place_topics": {
"app": 2,
"atmosphere": 2,
"buffet": 3,
"ice cream": 3,
"incredible pizza": 3,
"kids": 3,
"order": 3,
"pay": 3,
"the pizza": 4,
"vegan": 3
},
"websites_count": 3
},
"categoiries": [
"restaurant"
],
"type": "business_category"
}
],
"offset": null,
"offset_token": null,
"total_count": 26
}
],
"result_count": 1,
"status_code": 20000,
"status_message": "Ok.",
"time": "0.2798 sec."
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "0.3505 sec.",
"version": "0.1.20221214"
}Composite rule pricing
Calculated from input parameters and actual returned quantities. Estimate the maximum cost before calling.
Base fee: $0.012000. One matching variant replaces the base fee. Matching add-ons and quantity charges are added.
| Fee item | Price | Metering source | When | Quantity limit |
|---|---|---|---|---|
| 任务错误数必须为零 | $0.000000 / billing unit | Response · /tasks_error · Numeric value | Always | 0 billing unit · Decimal places: 0 |
| 本次返回结果 | $0.000360 / result | Response · /tasks/0/result/0/count · Numeric value | Always | 1000 result · Decimal places: 0 |
Each quantity charge is rounded before summing: ceil. Requests exceeding this cost limit are rejected; it is not a price cap: $0.372000.
Response quantities settle after the response. Before execution, the maximum quantity determines the reservation; unused reservation is released. Missing or invalid quantities are not treated as zero.
Pricing parameters and defaults
[]
Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# DataForSEO — Business Data / Business Listings / Categories Aggregation / Live
Retrieve business Data Business Listings Categories Aggregation Live with the DataForSEO API. The sample response includes titles. Use it for account research or company due diligence.
## Available implementations
DataForSEO · DataForSEO — Business Data / Business Listings / Categories Aggregation / Live: https://openany.si/markets/apis/capabilities/dataforseo-business-data-business-listings-categories-aggregation-live?offering=bd294f5a-d517-4ee5-a4e0-f151848e4c53 · $0.012 base + $0.00036 / result
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/dataforseo-business-data-business-listings-categories-aggregation-live
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live
Price: $0.012 base + $0.00036 / result
Provider: DataForSEO
Contract revision: 3
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '[
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
}
]'
```
## API contract
```json
{
"resource_type": "api",
"name": "DataForSEO — Business Data / Business Listings / Categories Aggregation / Live",
"endpoint": "https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live",
"method": "POST",
"content_type": "application/json",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": " Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category. The provided results are specific to the specified parameters.",
"json_schema": {
"example": [
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
}
],
"items": {
"example": [
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
}
],
"nullable": true,
"properties": {
"categories": {
"description": "business categories optional field the categories you specify are used to search for business listings; if you don't use this field, we will return business listings found in the specified location; you can specify up to 10 categories",
"items": {
"type": "string"
},
"nullable": true,
"type": "array",
"x-required-status": "optional"
},
"description": {
"description": "description of the element in SERP optional field the description of the business entity for which the results are collected; can contain up to 200 characters",
"nullable": true,
"type": "string",
"x-required-status": "optional"
},
"initial_dataset_filters": {
"allOf": [
{
"anyOf": [
{
"anyOf": [
{
"items": false,
"maxItems": 3,
"minItems": 3,
"prefixItems": [
{
"type": "string"
},
{
"type": "string"
},
{}
],
"type": "array"
},
{
"items": {
"anyOf": [
{
"type": "array"
},
{
"enum": [
"and",
"or"
],
"type": "string"
}
]
},
"minItems": 1,
"type": "array"
}
],
"description": "官方过滤器文档中的条件三元组或由 and/or 连接的条件数组;仅检查外层结构,嵌套数组、操作符和值的完整语义仍以官方文档为准。",
"x-coverage": "outer_structure_only_nested_operator_semantics_not_exhaustively_validated",
"x-schema-origin": "derived_from_official_filter_prose_and_examples"
},
{
"type": "null"
}
]
}
],
"description": "array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, match, not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"rating.value\",\">\",3] you can receive the list of available filters_by making a separate request to https://api.dataforseo.com/v3/business_data/business_listings/available_filters the full list of possible filters is available here. learn more about the initial dataset filters in this help center article.n",
"nullable": true,
"type": "array",
"x-original-openapi-description": "array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and , or between the conditions the following operators are supported: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , like , not_like , match , not_match you can use the % operator with like and not_like to match any string of zero or more characters example: [\"rating.value\",\">\",3] you can receive the list of available filters_by making a separate request to https://api.dataforseo.com/v3/business_data/business_listings/available_filters the full list of possible filters is available here. learn more about the initial dataset filters in this help center article.n",
"x-required-status": "optional",
"x-schema-origin": "official_filter_prose_normalized"
},
"internal_list_limit": {
"default": 10,
"description": "maximum number of elements within internal arrays optional field you can use this field to limit the number of elements within the aggregated categories default value: 10",
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default"
],
"x-required-status": "optional"
},
"is_claimed": {
"description": "indicates whether the business is verified by its owner on Google Maps optional field",
"nullable": true,
"type": "boolean",
"x-required-status": "optional"
},
"limit": {
"default": 100,
"description": "the maximum number of returned businesses optional field default value: 100 maximum value: 1000",
"maximum": 1000,
"nullable": true,
"type": "integer",
"x-constraints-from-official-description": [
"default",
"maximum"
],
"x-required-status": "optional"
},
"location_coordinate": {
"description": "GPS coordinates of a location optional field location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format the maximum number of decimal digits for \"latitude\" and \"longitude\": 7 the minimum value for \"radius\": 1 the maximum value for \"radius\": 100000 example: 53.476225,-2.243572,200 learn more about how to set location parameters in this API on our Help Center",
"nullable": true,
"type": "string",
"x-original-openapi-description": "GPS coordinates of a location optional field location_coordinate parameter should be specified in the \"latitude,longitude,radius\" format the maximum number of decimal digits for \"latitude\" and \"longitude\" : 7 the minimum value for \"radius\" : 1 the maximum value for \"radius\" : 100000 example: 53.476225,-2.243572,200 learn more about how to set location parameters in this API on our Help Center",
"x-required-status": "optional"
},
"offset": {
"description": "the maximum number of returned businesses optional field",
"nullable": true,
"type": "integer",
"x-required-status": "optional"
},
"tag": {
"description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response",
"nullable": true,
"type": "string",
"x-required-status": "optional"
},
"title": {
"description": "title of the element in SERP optional field the name of the business entity for which the results are collected; can contain up to 200 characters",
"nullable": true,
"type": "string",
"x-required-status": "optional"
}
},
"type": "object"
},
"maxItems": 1,
"minItems": 1,
"type": "array",
"x-openany-retail-scope": "single_native_task_per_sale_execution",
"x-openapi-version": "3.0.1",
"x-schema-origin": "official_openapi_plus_explicit_official_doc_amendments"
},
"location": "body",
"name": "body",
"nullable": false,
"pointer": "",
"required": true,
"type": "array"
}
],
"billing": {
"currency": "USD",
"mode": "rules",
"parameters": [],
"policy_version": 2,
"sale": {
"addons": [],
"base_price_micro_usd": "12000",
"max_cost_micro_usd": "372000",
"quantities": [
{
"id": "task_errors",
"label": "任务错误数必须为零",
"max_quantity": "0",
"measure": "value",
"pointer": "/tasks_error",
"price_micro_usd": "0",
"quantity_scale": 0,
"source": "response",
"unit": "task_error",
"unit_quantity": "1"
},
{
"id": "returned_results",
"label": "本次返回结果",
"max_quantity": "1000",
"measure": "value",
"pointer": "/tasks/0/result/0/count",
"price_micro_usd": "360",
"quantity_scale": 0,
"source": "response",
"unit": "result",
"unit_quantity": "1"
}
],
"rounding": "ceil",
"variants": []
}
},
"examples": [
{
"http_status": 200,
"name": "Official example · 官方历史成对样例(未运行) (HTTP assumed)",
"request": {
"body": [
{
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
}
],
"headers": {},
"path": {},
"query": {}
},
"response_body": {
"cost": 0.0109,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.0109,
"data": {
"api": "business_data",
"categories": [
"pizza_restaurant"
],
"description": "pizza",
"function": "categories_aggregation",
"initial_dataset_filters": [
[
"rating.value",
">",
3
]
],
"is_claimed": true,
"limit": 3,
"location_coordinate": "53.476225,-2.243572,10",
"title": "pizza"
},
"id": "04301510-1535-0545-0000-92269c6091b9",
"path": [
"v3",
"business_data",
"business_listings",
"categories_aggregation",
"live"
],
"result": [
{
"count": 3,
"items": [
{
"aggregation": {
"count": 32,
"top_attributes": {
"accepts_reservations": 17,
"feels_casual": 28,
"has_delivery": 32,
"has_no_contact_delivery": 20,
"has_takeout": 32,
"has_wheelchair_accessible_entrance": 17,
"pay_debit_card": 26,
"pay_mobile_nfc": 23,
"serves_dessert": 20,
"serves_dinner": 18
},
"top_categories": {
"delivery_service": 7,
"fast_food_restaurant": 4,
"italian_restaurant": 7,
"meal_takeaway": 3,
"neapolitan_restaurant": 6,
"pizza_delivery_service": 11,
"pizza_restaurant": 32,
"pizzatakeaway": 14,
"restaurant": 12,
"vegan_restaurant": 3
},
"top_countries": {
"GB": 32
},
"top_place_topics": {
"atmosphere": 6,
"cold": 5,
"dominos": 6,
"dough": 4,
"kids": 5,
"money": 7,
"order": 8,
"phone": 5,
"price": 9,
"vegan": 6
},
"websites_count": 18
},
"categoiries": [
"pizza_restaurant"
],
"type": "business_category"
},
{
"aggregation": {
"count": 14,
"top_attributes": {
"accepts_reservations": 9,
"feels_casual": 13,
"has_delivery": 14,
"has_no_contact_delivery": 10,
"has_takeout": 14,
"is_transgender_safespace": 9,
"pay_debit_card": 12,
"pay_mobile_nfc": 12,
"serves_dessert": 9,
"serves_late_night_food": 8
},
"top_categories": {
"buffet_restaurant": 1,
"family_restaurant": 2,
"fast_food_restaurant": 3,
"italian_restaurant": 2,
"meal_takeaway": 2,
"pizza_delivery_service": 8,
"pizza_restaurant": 14,
"pizzatakeaway": 14,
"restaurant": 8,
"vegan_restaurant": 2
},
"top_countries": {
"GB": 14
},
"top_place_topics": {
"app": 2,
"buffet": 3,
"call": 2,
"ice cream": 3,
"kids": 3,
"money": 3,
"order": 4,
"pay": 3,
"price": 5,
"the pizza": 3
},
"websites_count": 7
},
"categoiries": [
"pizzatakeaway"
],
"type": "business_category"
},
{
"aggregation": {
"count": 12,
"top_attributes": {
"accepts_reservations": 11,
"feels_casual": 11,
"has_delivery": 12,
"has_no_contact_delivery": 8,
"has_takeout": 12,
"has_wheelchair_accessible_entrance": 8,
"is_transgender_safespace": 11,
"pay_debit_card": 11,
"pay_mobile_nfc": 11,
"serves_dessert": 10
},
"top_categories": {
"buffet_restaurant": 1,
"delivery_service": 1,
"family_restaurant": 2,
"italian_restaurant": 3,
"neapolitan_restaurant": 3,
"pizza_delivery_service": 5,
"pizza_restaurant": 12,
"pizzatakeaway": 8,
"restaurant": 12,
"vegan_restaurant": 2
},
"top_countries": {
"GB": 12
},
"top_place_topics": {
"app": 2,
"atmosphere": 2,
"buffet": 3,
"ice cream": 3,
"incredible pizza": 3,
"kids": 3,
"order": 3,
"pay": 3,
"the pizza": 4,
"vegan": 3
},
"websites_count": 3
},
"categoiries": [
"restaurant"
],
"type": "business_category"
}
],
"offset": null,
"offset_token": null,
"total_count": 26
}
],
"result_count": 1,
"status_code": 20000,
"status_message": "Ok.",
"time": "0.2798 sec."
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "0.3505 sec.",
"version": "0.1.20221214"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · 官方历史成对样例(未运行) (HTTP assumed)
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 1
Review these request fields before running. Keep the published provider and request method unchanged.
body- Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category. The provided results are specific to the specified parameters.
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/dataforseo/v3/business_data/business_listings/categories_aggregation/live' \ -X POST \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '[ { "categories": [ "pizza_restaurant" ], "description": "pizza", "initial_dataset_filters": [ [ "rating.value", ">", 3 ] ], "is_claimed": true, "limit": 3, "location_coordinate": "53.476225,-2.243572,10", "title": "pizza" } ]'Check the response
Sample response · Configured HTTP 200; actual status is unverified.
Sample response