google_serp
Execute a full Google SERP search query with strict Google provenance (depth 10 to 100). Returns verified Google organic results with classification tagging (forums, video, ecommerce) and the results page's features (AI Overview, PAA, Knowledge Graph). The local pack and shopping are add-ons: set local pack and/or shopping to true to include them. A result searched in the last 24 hours is served from the cache at a lower price; set fresh to true to search live.
Показать схему аргументов
{
"type": "object",
"title": "google_serpArguments",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "us"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"depth": {
"type": "integer",
"title": "Depth",
"default": 10
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"query": {
"type": "string",
"title": "Query"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
},
"shopping": {
"type": "boolean",
"title": "Shopping",
"default": false
},
"local_pack": {
"type": "boolean",
"title": "Local Pack",
"default": false
}
}
}
find_discussion_candidates
Search Google and filter organic results (positions 1-100) specifically for community discussions and forum threads (Reddit, Quora, HackerNews, StackExchange, niche forums). Ideal for sentiment analysis, user discussions, and customer problem discovery.
Показать схему аргументов
{
"type": "object",
"title": "find_discussion_candidatesArguments",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "us"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"depth": {
"type": "integer",
"title": "Depth",
"default": 30
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"query": {
"type": "string",
"title": "Query"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
}
}
}
extract_local_places
Extract Google Local Pack (3-pack) and Google Places listings for local queries. Returns place id/cid, title, rating, review count, address, latitude/longitude, category, phone, and website.
Показать схему аргументов
{
"type": "object",
"title": "extract_local_placesArguments",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "us"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"query": {
"type": "string",
"title": "Query"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
}
}
}
extract_shopping_results
Extract Google Shopping carousel listings for e-commerce and product queries. Returns product title, price, currency, merchant, rating, reviews, image URL, link, and product ID.
Показать схему аргументов
{
"type": "object",
"title": "extract_shopping_resultsArguments",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "us"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"query": {
"type": "string",
"title": "Query"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
}
}
}
geo_citation_radar
Run GEO Citation & Injection Radar for a topic query and brand. Calculates citation probability score (0-100), identifies high-impact Reddit/Quora threads with injection playbooks, extracts listicle PR outreach targets with Vera contacts payload, discovers AEO question gaps from PAA, and produces an LLM-ready markdown injection brief.
Показать схему аргументов
{
"type": "object",
"title": "geo_citation_radarArguments",
"required": [
"query"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "ae"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand",
"default": null
},
"depth": {
"type": "integer",
"title": "Depth",
"default": 30
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"query": {
"type": "string",
"title": "Query"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Domain",
"default": null
},
"engine": {
"type": "string",
"title": "Engine",
"default": "google"
},
"location": {
"type": "string",
"title": "Location",
"default": "Dubai"
}
}
}
company_serp_footprint
Audit a company's SERP digital footprint, brand reputation, owned domains, and entity profiles. Separates owned web properties, social/entity profiles (Wikipedia, LinkedIn, Instagram, Crunchbase), Google Maps locations, third-party mentions, and customer brand questions (PAA).
Показать схему аргументов
{
"type": "object",
"title": "company_serp_footprintArguments",
"required": [
"company"
],
"properties": {
"gl": {
"type": "string",
"title": "Gl",
"default": "ae"
},
"hl": {
"type": "string",
"title": "Hl",
"default": "en"
},
"depth": {
"type": "integer",
"title": "Depth",
"default": 20
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Domain",
"default": null
},
"company": {
"type": "string",
"title": "Company"
},
"location": {
"type": "string",
"title": "Location",
"default": "Dubai"
}
}
}
keyword_ideas
Keyword ideas for a seed keyword from Google autocomplete (the seed plus question words or the alphabet), People Also Ask and related searches, cleaned and de-duplicated. Each idea carries its sources and an intent label (question, comparison, commercial, local, informational). Works in Arabic. Ideas only: no search volumes. Charged for the results page (7 credits live, 1 from your cache) plus 7 credits for each autocomplete call that returns suggestions, so at most 14 credits for expand 'none', 70 for 'questions' (the default), 196 for 'alphabet' (210 for an Arabic seed) and 217 for 'all'; it
Показать схему аргументов
{
"type": "object",
"title": "keyword_ideasArguments",
"required": [
"seed"
],
"properties": {
"gl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Gl",
"default": null
},
"hl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Hl",
"default": null
},
"seed": {
"type": "string",
"title": "Seed"
},
"fresh": {
"type": "boolean",
"title": "Fresh",
"default": false
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50
},
"expand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Expand",
"default": null
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null
},
"location_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Location Code",
"default": null
}
}
}
ai_answers
Put a buyer's question to an AI assistant that searches the live web, and see whether a brand and its competitors are named in the answer, in what rank, with the citations and cited domains behind it. The assistant is ChatGPT unless engine names claude, perplexity or gemini; an assistant the server has no key for answers not configured and costs nothing. samples (1 to 5, default 1) asks the same question more than once, for a mention rate. Returns metrics per assistant, not the raw answers. Charged per call to the assistant at the price list in credits (see llms.txt), the same as POST /v1/ai/a
Показать схему аргументов
{
"type": "object",
"title": "ai_answersArguments",
"required": [
"prompt",
"brand"
],
"properties": {
"brand": {
"type": "string",
"title": "Brand",
"description": "Brand name to look for in the answer"
},
"engine": {
"enum": [
"chatgpt",
"claude",
"perplexity",
"gemini"
],
"type": "string",
"title": "Engine",
"default": "chatgpt",
"description": "The assistant to ask"
},
"prompt": {
"type": "string",
"title": "Prompt",
"description": "The question to put to the assistant, as a buyer would ask it"
},
"country": {
"type": "string",
"title": "Country",
"default": "ae",
"description": "Two-letter ISO country code of the market"
},
"samples": {
"type": "integer",
"title": "Samples",
"default": 1,
"maximum": 5,
"minimum": 1,
"description": "Times the question is asked of the assistant"
},
"language": {
"type": "string",
"title": "Language",
"default": "en",
"description": "Language tag of the market, for example en or ar"
},
"competitors": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Competitors",
"default": null,
"description": "Competitor names or domains to track"
},
"brand_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Brand Domain",
"default": null,
"description": "The brand's domain, for example roasters.ae"
}
}
}