Log inHow it WorksGet a demo
Get a demoHow it Works
Compare keywords by region

Compare keywords by region: which term wins where

Put your product against a rival and get the winner in every state from one call. €0.0015 per call, about 51 rows for the US.

Start freeSee all data APIs
per 1,000 calls
€1.50
per call
€0.0015
0.15 cents
rows per call
up to 51
per 1,000 rows
≈ €0.0294

Head to head, state by state

The compare regions API takes two or more search terms and tells you which one people search more in each region. For the US that's about 51 rows, the 50 states plus Washington DC, from one call at €0.0015. A thousand comparisons cost €1.50. All other sources and prices are on our data APIs page. Save your terms once, and every run's regional scoreboard is stored in your Scrapewise account for the table, Excel, your AI assistant or the API.

Each row answers one question: in this state, which of my terms leads? The answer is a number that points back to your list. 0 is the first term you typed, 1 the second, and so on.

We tested it on 16 September 2026 with "bitcoin, ethereum" in the US. Bitcoin led in all 51 regions. A clean sweep is an answer too. If you'd been planning a regional campaign for the second term, you'd know there's no state where it's ahead.

This page is for match-ups. If you only care about one keyword and want to know how strong it is in each state, the interest by region API scores one term from 0 to 100 per region. Use this one when the question has a "versus" in it.

Who compares terms by region

  • Brands with a named rival

    Your brand against the market leader. Find the states where you already win and spend there first, and the states where you lose before a rep flies out.

  • Sellers writing local listings

    Do shoppers in Georgia type "sneakers" or "tennis shoes"? Compare the two and use the winning word in titles and ads for that area.

  • Multi-warehouse sellers

    Stock the variant that wins in each warehouse's states. A two-term comparison per product line tells you which color, flavor or size name leads where.

How it works

  1. List your terms

    Type two or more terms separated by commas, like 'stanley cup, yeti tumbler'. The order is how you'll read the results. The country is US by default.

  2. Pick a range and schedule

    The range defaults to the past 12 months. Schedule it monthly, and each run is saved with its date.

  3. Read the leader per region

    Count rows per term in the table or Excel, pull rows by API, or ask your AI assistant: 'in how many states does stanley cup lead this month?'

Set it up once. The data keeps coming.

Save your search once and it runs by itself. Every run lands in your own Scrapewise database, and you pick how to read it.

  1. Set it up once

    Add your ASINs, keywords, places or apps to a scraper in the web app. New accounts get 5 free requests.

  2. Runs on your schedule

    Pick daily, weekly on the days you choose, every few days, or the first or last day of the month. Scheduled runs start at night, European time. Need it more often? Start runs from your own code.

  3. Saved in your database

    Each run adds dated rows, so this week sits next to last week. Rows are kept for 90 days.

  4. Use it your way

    Open the table in the web app and download the latest run as an Excel file. Ask your own AI assistant about it. Or pull the rows into your code with an API key.

Ask your AI assistant about your own data

Connect Claude Desktop, Claude Code or another MCP app with a read-only key. The assistant reads the rows you've already collected, at no extra cost on Scrapewise. With a full-access key it can start a run for you too.

  • Which of my ASINs lost the Buy Box this week?
  • Which competitor cut prices the most since Monday?
  • Show the keywords where I dropped out of the top 10.

What you send and what you get back

You send two or more comma-separated terms, plus a country code and time range if you want them. You get one row per region with its name, its code and the index of the leading term.

You give
  • Search termrequired
    bitcoin
  • Location (country code)optional
    US
  • Time rangeoptional
    today 12-m
  • Data typeoptional
    GEO_MAP
You get

Up to 51 rows per call, 18 columns each

  • sw status
  • sw source url
  • sw position
  • sw title
  • sw url
  • sw external id
  • sw id kind
  • sw location
  • sw fetched at
  • geo
  • location
  • max_value_index
  • +6 more, see all columns

Sample rows: "bitcoin, ethereum" in the US

Real rows from a call on 16 September 2026, past 12 months. max value index 0 means bitcoin, the first term, leads in that state. The value fields came back empty on this comparison, so read the leader column.

All 18 columns

  • sw status
  • sw source url
  • sw position
  • sw title
  • sw url
  • sw external id
  • sw id kind
  • sw location
  • sw fetched at
  • geo
  • location
  • max_value_index
  • value
  • extracted_value
  • ctx_search_parameters_q
  • ctx_search_parameters_geo
  • ctx_search_parameters_date
  • ctx_search_metadata_google_trends_url

8 sample rows, 18 columns. One call returns up to 51 rows.

8 sample rows, 18 columns. One call returns up to 51 rows.
sw status_sw_statusResult of this row: OK, no results, or an errorsw source url_sw_source_urlThe input you gave: a link, keyword or IDsw position_sw_positionRank of the item as the site shows itsw title_sw_titleMain name of the itemsw url_sw_urlDirect link to the itemsw external id_sw_external_idThe site's own ID for this itemsw id kind_sw_id_kindWhat kind of ID the external ID issw location_sw_locationPlace the result is priced or ranked forsw fetched at_sw_fetched_atWhen we collected this row (UTC)geogeoRegion codelocationlocationRegion namemax_value_indexmax_value_indexMax value indexvaluevalueValue as shownextracted_valueextracted_valueNumeric valuectx_search_parameters_qctx_search_parameters_qRequest context: search parameters qctx_search_parameters_geoctx_search_parameters_geoRequest context: search parameters geoctx_search_parameters_datectx_search_parameters_dateRequest context: search parameters datectx_search_metadata_google_trends_urlctx_search_metadata_google_trends_urlRequest context: search metadata google trends url
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US1Alaskahttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-AKtopicUS-AK2026-09-16T11:11:42ZUS-AKAlaska00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US2Alabamahttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-ALtopicUS-AL2026-09-16T11:12:19ZUS-ALAlabama00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US3Arkansashttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-ARtopicUS-AR2026-09-16T11:12:56ZUS-ARArkansas00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US4Arizonahttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-AZtopicUS-AZ2026-09-16T11:13:33ZUS-AZArizona00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US5Californiahttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-CAtopicUS-CA2026-09-16T11:14:10ZUS-CACalifornia00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US6Coloradohttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-COtopicUS-CO2026-09-16T11:14:47ZUS-COColorado00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US7Connecticuthttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-CTtopicUS-CT2026-09-16T11:15:24ZUS-CTConnecticut00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D
OKhttps://trends.google.com/trends/explore?q=bitcoin%2Cethereum&geo=US8District of Columbiahttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7DUS-DCtopicUS-DC2026-09-16T11:16:01ZUS-DCDistrict of Columbia00bitcoin,ethereumUStoday 12-mhttps://trends.google.com/trends/embed/explore/GEO_MAP?hl=en&tz=420&req=%7B%22category%22%3A0%2C%22comparisonItem%22%3A%5B%7B%22geo%22%3A%22US%22%2C%22keyword%22%3A%22bitcoin%2Cethereum%22%2C%22time%22%3A%22today+12-m%22%7D%5D%2C%22property%22%3A%22%22%7D

What each column means

sw columns are shared by all Scrapewise data APIs. The others come straight from Google Trends.

The region

location is the region's name and geo its code, like US-AK. sw title repeats the name and sw location repeats the code. sw position is the row's place in the list, which Google sorts by region code.

  • location
  • geo
  • sw title
  • sw location
  • sw position

Who leads

max value index is the answer: 0 for your first term, 1 for the second, and so on. value and extracted value hold a score when Google supplies one. On a comparison they're often empty, as in the sample.

  • max_value_index
  • value
  • extracted_value

Row identity and links

sw external id is the region code, so rows match across monthly runs, and sw id kind says what kind of ID it is. sw source url opens the comparison on Trends, sw url is the map it came from, sw status says OK, no results or error, and sw fetched at is when we collected it in UTC.

  • sw external id
  • sw id kind
  • sw source url
  • sw url
  • sw status
  • sw fetched at

Your request

ctx search parameters q holds your full term list in the order you sent it. Keep it next to max value index so 0 and 1 always mean the right thing. Country, range and the Trends link sit beside it.

  • ctx_search_parameters_q
  • ctx_search_parameters_geo
  • ctx_search_parameters_date
  • ctx_search_metadata_google_trends_url

What sellers do with a regional match-up

01

Target ads where you already win

Compare your brand with a rival and put ad budget in states where your index leads. Winning ground is cheaper to hold than losing ground is to take.

02

Choose the local word

"Soda" or "pop", "hoodie" or "sweatshirt". One call shows which word leads in each state so your listing matches what local buyers type.

03

Split regional stock

Run one comparison per product line. If the matte version leads in the West and the glossy one in the South, ship accordingly.

04

Pick test markets

Compare your category term with the older alternative. Launch in states where the new term already leads, because buyers there already know what they're looking for.

05

Track a rival's spread

Rerun the same pair every month and count how many states each term leads. A rival going from 5 states to 12 is a story worth hearing early.

What it costs in real life

  • Brand manager watching rivals

    Compares the brand with 4 competitors, one pair each, every week. About 17 calls a month, around €0.03.

    calls per month
    17
    cost per month
    €0.0255

  • Seller with 3 warehouses

    Runs 40 product-variant comparisons once a month to split stock. 40 calls, €0.06.

    calls per month
    40
    cost per month
    €0.06

  • Agency with 25 clients

    Tracks 3 rival pairs per client every week for regional reports. About 325 calls, roughly €0.49 a month.

    calls per month
    325
    cost per month
    €0.487

Why use this API for regional match-ups

  • The winner, not a pile of charts

    One row per state with the leading term. No need to pull each keyword separately and line them up yourself.

  • Your order is kept

    The term list you sent is stored on every row, so the leader index still reads correctly months later.

  • Cents, not a subscription

    Four weekly match-ups, one per rival, cost about €0.03 a month. Nothing to pay when you stop.

What your comparisons cost

One comparison is one call at €0.0015, for 2 terms or 5. Enter how many match-ups you run and how often. Compare all data APIs

Rows (up to)
51,000
You pay
€1.50
FAQ

Frequently asked questions

Two or more, separated by commas, in one call. Google Trends compares up to 5 terms at a time, so split longer lists into groups that share one anchor term.

Ready to pull Compare data into your stack?

5 requests are free when you sign up. After that, top up from €5 and pay €0.0015 per comparison. Pay-as-you-go pricing has the details.

Start freeSee all data APIs

Explore other data APIs

View all 36 →
Google TrendsGoogle Trends API: demand over time and by region in one callGet Google Trends data as rows: weekly interest over time plus interest by region, both in one call for €0.0015. No pytrends breakage.View data API →Google TrendsGoogle Trends interest over time API: a weekly series per keywordGet Google Trends interest over time as a weekly series with real dates, for one keyword or several. €0.0015 per call, ready to chart.View data API →Google TrendsGoogle Trends interest by region API: where one keyword is hotSee where one keyword is searched most, region by region, scored 0 to 100. €0.0015 per call. Pick ad targets and stock locations.View data API →Google TrendsGoogle Trends related queries API: top and rising searchesGet the searches people make around your keyword: 25 top and 25 rising, including breakouts. €0.0015 per call. New keyword ideas each week.View data API →