Search Console tools
Query and page performance, low-CTR pages, URL inspection, sitemaps and comparison with ads.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.
Outils de lecture7 outils
list_search_console_sites
Lecture1 créditsVerified Search Console properties the connected Google account can read, with permission level and the default property used when site_url is omitted.
Cet outil ne prend aucun paramètre.
search_console_query
Lecture1 créditsSearch Console performance report (clicks, impressions, ctr %, average position) for any date range by query, page, country, device, date or searchAppearance, with AND filters. compare_previous=true adds the previous equal period and per-row change; order_by=clicks_change with order=asc lists the biggest losers. Requires a connected Google account; otherwise returns connected=false.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | window ending today when dates are omitted (default 28) |
dimensionsFacultatif | array<query | page | country | device | date | searchAppearance> | default [query] |
filtersFacultatif | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsFacultatif | array<string> | brand terms to exclude from query (non-brand report) |
pageFacultatif | string | restrict to one page URL |
countryFacultatif | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
search_typeFacultatif | web | image | video | news | discover | googleNews | — |
row_limitFacultatif | integer (1–5000) | — |
start_rowFacultatif | integer (0–…) | — |
compare_previousFacultatif | boolean | also fetch the immediately preceding period of equal length and add previous/change per row |
order_byFacultatif | clicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change | — |
orderFacultatif | asc | desc | — |
search_console_top_queries
Lecture1 créditsTop queries by clicks (or impressions/ctr/position) for the period; pass exclude_terms with brand words for a non-brand list.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | window ending today when dates are omitted (default 28) |
filtersFacultatif | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsFacultatif | array<string> | brand terms to exclude from query (non-brand report) |
pageFacultatif | string | restrict to one page URL |
countryFacultatif | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
limitFacultatif | integer (1–1000) | — |
order_byFacultatif | clicks | impressions | ctr | position | — |
search_console_low_ctr_pages
Lecture2 créditsPages (or queries) with high impressions but low CTR — candidates for a title/meta description rewrite. Defaults: impressions ≥ 1000 and ctr < 2 %. Sorted by impressions.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
daysFacultatif | integer (1–480) | window ending today when dates are omitted (default 28) |
filtersFacultatif | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsFacultatif | array<string> | brand terms to exclude from query (non-brand report) |
pageFacultatif | string | restrict to one page URL |
countryFacultatif | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
dimensionFacultatif | page | query | — |
min_impressionsFacultatif | number | — |
max_ctrFacultatif | number | percent, default 2 |
limitFacultatif | integer (1–500) | — |
inspect_url
Lecture1 créditsURL Inspection: indexed or not, coverage state, last crawl time, robots/indexing state, Google vs user canonical, mobile usability and rich result verdicts. Read only.
| Paramètre | Type | Description |
|---|---|---|
urlObligatoire | string | full URL under the property |
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
list_sitemaps
Lecture1 créditsSitemaps submitted for the property with last submitted/downloaded time, pending flag, warning and error counts and content type counts.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
search_console_vs_ads
Lecture2 créditsOrganic vs paid on the same terms: Search Console clicks/impressions/position per query next to Google Ads search-term impressions, clicks, spend and conversions for the last N days (default 28). If Google Ads is not connected the paid column is empty with a note.
| Paramètre | Type | Description |
|---|---|---|
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
daysFacultatif | integer (1–90) | — |
filtersFacultatif | array<object> | AND-combined dimension filters (e.g. query notContains brand, page equals URL) |
exclude_termsFacultatif | array<string> | brand terms to exclude from query (non-brand report) |
pageFacultatif | string | restrict to one page URL |
countryFacultatif | string | ISO 3166-1 alpha-3, e.g. TUR |
deviceFacultatif | DESKTOP | MOBILE | TABLET | — |
limitFacultatif | integer (1–500) | — |
Outils d'écriture2 outils
submit_sitemap
Écriture2 créditsSubmit (or resubmit) a sitemap to Search Console. Creates an approval item with a preview showing the property and sitemap URL; sent to Google only after approval and only with a connected account.
| Paramètre | Type | Description |
|---|---|---|
sitemap_urlObligatoire | string | — |
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_sitemap
ÉcritureIrréversible2 créditsRemove a sitemap from Search Console. Goes through preview and approval; applied only after the user approves.
| Paramètre | Type | Description |
|---|---|---|
sitemap_urlObligatoire | string | — |
site_urlFacultatif | string | Search Console property, e.g. https://example.com/ or sc-domain:example.com. Omit to use the connected default. |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.