{"openapi":"3.1.1","info":{"title":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): What advertisers bid to show at the top of Google for lawyer searches, practice by practice. For 86 query families (English and Spanish) in the whole US, all 50 states and DC, the file gives the top-of-page bid band of each family's English and Spanish head query (Google Keyword Planner's low and high top-of-page bid estimates: the range advertisers have historically bid to show above the results), the competition level and index, plus the family's median low and high bids across its queries. Figures come from Google Ads Keyword Planner (October 2025 to September 2026) and are shown as bands with that period; for the US and 27 states, a DataForSEO pull of the same Google Ads data agrees on every bid band it shares. For the US, families are grouped into demand tiers by searches a month with the median high bid of each tier. Our own anonymized benchmark of what law-firm clicks actually cost is linked as a separate measure and never mixed into these figures.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/ad-costs/index.json":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): index","description":"ad-costs: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/changes.json":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): confirmed changes","description":"ad-costs: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/jurisdictions/{key}.json":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): one jurisdiction","description":"ad-costs: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"},"example":"AK"}],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/ad-costs.csv":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner) as CSV","description":"ad-costs: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner) as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/ad-costs.json":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): every record","description":"ad-costs: every record in one file","parameters":[],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/search.json":{"get":{"summary":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): keyword index","description":"ad-costs: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Google search-ad costs for lawyer searches by practice area and state: top-of-page bid bands and competition (Google Ads Keyword Planner): keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}},"/data/v1/ad-costs/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"ad-costs: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["ad-costs"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":"string"},"doiUrl":{"type":"string"},"conceptDoi":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"}},"additionalProperties":true}}}}