Agentic Platform
Documentation API reference Tools Skills

Tools

Google People Also Search

google_people_also_search Keywords Google

Retrieve the Google 'People Also Search' questions for a specific query

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item
query required The search query to analyze
config
location_id Location ID (optional)
location_request Location request (ex: Paris, FR), will translate to location ID
country_code ISO3166 country code (ex: GB)
lang_code BCP47 language code (ex: "en", "en-GB")
device Device to use for search (optional - defaults to mobile)

Billing

Fixed cost per keyword requested, plus one set of search results per keyword: the related searches are read off the results page. Called while you wait it uses search results (live); submitted as a background batch it uses search results (async), which costs appreciably less, and collecting the finished batch is free.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item, on top of any usage below.
Search results (async) 6 per 10 query The same search-results page, submitted as a background batch. Markedly cheaper than running the query while you wait.
Search results (live) 2 per query One organic search-results page for one query, fetched while you wait.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
query string required

The search query to analyze

max length 700

Example
{
  "query": "string"
}

Configuration

object
Properties
location_id integer | null

Location ID (optional)

Default: null

location_request string | null

Location request (ex: Paris, FR), will translate to location ID

Default: null

country_code string | null

ISO3166 country code (ex: GB)

Default: null

lang_code string | null

BCP47 language code (ex: "en", "en-GB")

Default: null

device string

Device to use for search (optional - defaults to mobile)

Values: mobile desktop

Default: "mobile"

Example
{
  "location_id": null,
  "location_request": null,
  "country_code": null,
  "lang_code": null,
  "device": "mobile"
}

Response

object
Properties
results array required

List of People Also Search questions with their details

Example
{
  "results": [
    "string"
  ]
}

Endpoints

POST http://agents.botify.com/{organization}/{project}/google_people_also_search/process
POST http://agents.botify.com/{organization}/{project}/google_people_also_search/batch_process
POST http://agents.botify.com/{organization}/{project}/google_people_also_search/async_process
POST http://agents.botify.com/{organization}/{project}/google_people_also_search/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/google_people_also_search/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "query": "<query>"
  }
}'

Raw metadata