Builders HQ

What a search engine knows about URLs of your site (up to 20 in one call). Google (default, Search Console's URL Inspection): indexed or not and why, last crawl, Google's chosen canonical, robots.txt and fetch state, sitemaps that list it, mobile usability and rich results; quota 2,000 a day per site. Bing (source "bing_webmaster"): HTTP status, when Bing found and last crawled it, size, links pointing to it.

inspect_url

Related keywords with their average monthly searches, competition and bid range, found from seed keywords, a page URL, both, or a whole site. The vendor returns up to 1,000 ideas; the filters (min_volume, contains, exclude, competition) and limit decide which come back, most searched first by default. All seeds go in one call (up to 20), and the ideas come back for them together.

keyword_ideas

Your own ad accounts on Meta (Facebook / Instagram; source meta_ads) or Microsoft Advertising (Bing Ads; source bing_ads): id, name, currency, time zone, status, and Meta's total spent to date, spend cap and business, or Microsoft's account number and pause reason. Read-only.

list_ad_accounts

The campaigns, ad sets / ad groups, ads or keywords in one of your ad accounts on Meta (meta_ads) or Microsoft Advertising (Bing Ads; bing_ads), with status (and why not running), objective or campaign type, optimization goal, bid strategy, daily or lifetime budget and what is left, start and end, bids, each ad's creative (title or headlines, text or descriptions, call to action, link) and each keyword's match type and bid (Microsoft). Read-only: nothing is changed.

list_ad_campaigns

The sites a web-analytics source can report on: every Cloudflare zone the token reads, or every Vercel project on the team with its domains.

list_analytics_sites

The data vendors behind this server: which are set up, what each can answer (keyword numbers, search performance, URL submission, video and traffic numbers) and its limits. Every other tool takes `source` to pick one.

list_sources

The page URLs a site's sitemaps list, with each one's lastmod: read from the sitemap files Search Console has for the site (or the one named), sitemap indexes and .gz followed. Search Console itself only counts them; use this to see which pages they are, then inspect_url or submit_urls on them. Only files on the site's own host are read.

list_sitemap_urls

The sitemaps submitted for a site: URLs submitted and indexed, last download, errors and warnings. Google Search Console by default; source "bing_webmaster" asks Bing Webmaster Tools.

list_sitemaps

Every site the account has, with its permission level or verification. Google Search Console by default; source "bing_webmaster" asks Bing Webmaster Tools.

list_sites

Places on Google Maps in full (up to 10 in one call): rating, review count, categories, address, phone, website, opening hours, coordinates, place id and Maps link.

place_details

Reviews of one place on Google Maps: stars, text, when, and who. Through the Google Places API: up to 5 per place, Google's choice of the most relevant.

place_reviews

Remove a site from the account. Changes the real account. Google Search Console by default; source "bing_webmaster" asks Bing Webmaster Tools.

remove_site

Remove a submitted sitemap from a site. Changes the real account. Google Search Console by default; source "bing_webmaster" asks Bing Webmaster Tools.

remove_sitemap

Apps on Apple's App Store and Google Play for one search or several (queries, up to 10), as each store ranks them: name, developer, rating, installs (Play) or rating count (App Store), category, store id and link. For competitors, a category ("video editor"), or a name.

search_apps

A site's search performance: clicks, impressions, CTR and average position, in total and broken down. Google (default, the Search Console Performance report): by any of query, page, country, device, date, searchAppearance, hour, for web, image, video, news, Discover or Google News; filter by query, page, country, device or search appearance (exact, contains or regex); compare with the period before or a year earlier; page through up to 100,000 rows. Data goes back 16 months and final data lags about two days; hour needs data_state "hourly_all" and covers only the last few days. Bing (source "bing_webmaster"): by query, page and date only, web only, about six months, queries and pages in weekly rows; query and page together need a filter pinning one of them. Search Console's own parameter names (startDate, endDate, rowLimit, startRow, searchType, dataState, aggregationType, dimensionFilterGroups) work too.

search_performance

Places on Google Maps for a search, as Maps lists them: name, rating, review count, categories, address, phone, website, opening hours, coordinates and place id. Put the area in each query ("padel club in Miami"), or give near (a point and radius). Up to 20 per query, up to 5 queries.

search_places

Search YouTube and get each result with its public numbers. Order by relevance, date, view count or rating; narrow by region, language, channel, publish dates and length. Up to 5 searches in one call; each spends 100 of the 10,000 daily quota units: ask once, then filter.

search_videos

Average monthly searches, competition and the top-of-page bid range for a list of keywords you already have, in the locations and language given. Use it to size or compare known keywords; use keyword_ideas to find new ones. A keyword the vendor counts together with another spelling says so (counted_as / same_as); one with no data is listed in no_data. Send every keyword in one call (up to 1,000 for Google Ads and Microsoft Ads, 50 for Bing Webmaster), not one call per keyword. source "microsoft_ads" answers from Microsoft Advertising's planner (Bing's ad side; US, GB, CA, AU, DE, FR only).

keyword_volume

A site's traffic over a period, in total and day by day. Vercel: visitors and page views (production, no bots). Cloudflare: visits and page views from its Web Analytics beacon where the site has it (up to 13 weeks), plus every request at the edge (bots included): requests, page views, unique IPs per day, bandwidth, cache share and threats.

site_traffic

Tell search engines that pages were added, changed or deleted, so they crawl them now. IndexNow (default; Bing, Yandex, Seznam, Naver; no quota, up to 10,000 URLs a call) for the hosts that have an IndexNow key; source "bing_webmaster" submits through Bing Webmaster Tools instead (any verified site, within a daily quota). check: true sends nothing and says whether each host is ready (key file found, quota left).

submit_urls

Submit (or resubmit) a sitemap URL for a site, so the search engine reads it again. Google Search Console by default; source "bing_webmaster" asks Bing Webmaster Tools.

submit_sitemap

A site's top values of one dimension over a period: path, country, referrer, device, browser, os, host, status, route, utm_source, utm_medium, utm_campaign (each source says which it has). measure "visitors" (default) counts real visits and page views; on Cloudflare, "requests" counts every request at the edge instead (bots included, at most 30 days; it is the only way to see status codes).

traffic_breakdown

A video's top-level comments with likes and reply counts: the most relevant or the newest, optionally only those containing a phrase.

video_comments

Public numbers for any videos: views, likes, comments, views per day since publishing, length, publish date, tags, language and description. Takes video URLs (watch, youtu.be, Shorts, live) or ids, up to 200.

video_stats

Your own channels' YouTube Analytics (the channels connected on the account page): overview (views, watch time, average view, subscribers gained and lost, likes, comments, shares), daily, videos (the top videos with titles), traffic_sources (search, suggested, browse, external...), search_terms (what people typed on YouTube before watching), countries or devices. Give video for one video's numbers. With several channels connected, say which with channel. Numbers settle 2-3 days late.

youtube_analytics