The hosted Actor accepts one required field and six optional fields.
| Field | Type | Required | Default | Accepted values | Description |
|---|---|---|---|---|---|
queries |
string[] |
Yes | — | 1–1,000 items | Search terms. Blank entries and duplicates are discarded. |
maxResultsPerQuery |
integer |
No | 10 |
1–50 | Maximum unique organic results per query across all pages. |
pagesPerQuery |
integer |
No | 1 |
1–20 | Maximum Bing result pages to inspect per query. |
country |
string |
No | US |
50 country codes | Country used to localize the Bing market and interface. |
safeSearch |
string |
No | Moderate |
Strict, Moderate, Off |
Bing SafeSearch setting. |
includeSerpFeatures |
boolean |
No | true |
true or false |
Adds query-level modules from the first fetched page. |
includeAds |
boolean |
No | false |
true or false |
Adds sponsored results under serpFeatures.ads; ads are not organic rows. |
US, ES, GB, DE, FR, IT, CA, MX, BR, AU, JP, IN, NL, PL, TR, KR, ID, AR, CO, SE, CH, AT, BE, DK, FI, NO, IE, PT, CZ, RO, HU, GR, IL, SA, AE, ZA, NZ, SG, MY, TH, VN, PH, TW, HK, CN, CL, PE, UY, EC, VE.
Pagination can stop before the requested page count when the maximum result count is reached, a page produces no new organic URLs, Bing returns an error or the query time budget is reached. Inspect paginationStoppedReason and pagesFetched in the output.