Manual
Product site My Page

Checking Search Rankings

Last updated · Published · Sorabun Editorial Team

Sorabun measures the Google ranking of each keyword you register every day and tracks the trend. This page also covers recording whether you are cited in AI Overviews and in the answers of Gemini, ChatGPT, Claude and Perplexity, measuring on mobile, by city and down to 100 positions with DataForSEO and what it costs, the end of Google Custom Search, and the API keys you need.

Register a keyword, and it's measured every day

Register a keyword under the "Rank Tracking" tab in "Sorabun > Measure / Analyze," and Sorabun automatically measures its Google search ranking every day. You can see the change from last time, the best rank achieved, and the overall trend.

The "Change" column shows not just the difference from last time but also the slope across your entire history (how many positions you move per week). A day-to-day difference only tells you about a single up or down, so this lets you tell "it happened to rise" apart from "it keeps rising." The slope is calculated with a method that resists outliers (Theil-Sen estimation), so a single day that fell out of the rankings doesn't drag the line off course.

The rank list. Columns for the change from last time, the weekly slope, and AI Overviews sit side by side
The rank list. Columns for the change from last time, the weekly slope, and AI Overviews sit side by side

Whether You're Cited in AI Overviews

Alongside the rank check, Sorabun also records whether your site appears as a cited source in Google's AI Overviews (Serper.dev / SerpApi / DataForSEO). This is read from the same API response, so it costs nothing extra.

The "AI Overview" column has three possible states.

  • Cited: your site appears among the AI Overview's cited sources
  • Shown: an AI Overview appears, but your site isn't among its sources. This is where to focus next. It's worth restructuring the article around a conclusion-first format (the AIO optimization type)
  • None: no AI Overview appears for that search term

Above the list, a summary shows how many keywords you're cited for. This lets you not just write in a citable format, but check every day whether it actually got cited.

Whether You're Cited in the Answers of Gemini, ChatGPT, Claude and Perplexity (AI Citations)

AI Overviews can be read straight from the rank check response, but whether other AI services cite your site as a source is something you can only find out by actually asking them. Click "Check AI Citations" on the rank check screen, and Sorabun asks that keyword to every AI you have an API key for, then records whether your site appears among the answer's sources in the "AI Citation" column.

AIKeyHow it is askedWhat counts as a source
Geminigemini_api_keyWith Google SearchThe search results the answer was grounded on
ChatGPTopenai_api_keyWith web searchThe citations attached to the answer
Claudeanthropic_api_keyClaude Sonnet 5.5, with web searchThe citations attached to the answer
Perplexityperplexity_api_keySonar, with web searchThe search results listed as the answer's sources

Claude and Perplexity are asked the same way as in AI Recommendation (LLMO).

The question is phrased the way an ordinary user would ask ("Tell me about X."). Up to 2.132.0 it also asked the AI to "search the web and cite the sources you used, with their URLs," but asking that makes an AI search more and list more sources than it normally would. Since 2.133.0 Sorabun no longer asks for it, so the AI decides whether to search. "No sources" may become more frequent, and results from before and after this version cannot be compared directly.

  • Cited: your site appears among the answer's sources
  • Not cited: sources are shown, but your site isn't among them. Hover over it to see who is cited instead
  • No sources: the AI answered without citing sources (a question it didn't search for; this is also shown when the AI declined to answer)

Each AI costs a few yen to a little over 10 yen per check (about $0.08 for Claude and about $0.006 for Perplexity, estimated from each provider's prices in November 2026), so it isn't checked automatically by default. Turn on "Settings > Search Data Source > AI Citation Check" (ai_cite_enabled) and Sorabun checks it once a week, alongside your daily rank check. It only uses the AI services you've set up a key for, and it keeps nothing but the citation mark and the source domains, never the full text of the AI's answer.

On the Cloud edition, Gemini and ChatGPT are always available. Claude and Perplexity are used only when you enter your own API keys on the Settings screen (the Sorabun server cannot call them, so your site asks each provider directly, and you pay for those checks from your own account).

Required setup

Fetching rankings uses a SERP API. Set up one of the following under "Settings > Search Data Source."

  • Serper.dev (serper_api_key): Inexpensive. Recommended
  • SerpApi (serpapi_api_key)
  • DataForSEO (dataforseo_login and dataforseo_password, the same ones used for search volume): measures on mobile, by city and down to position 100 (see "Measuring with DataForSEO" below)
  • Google Custom Search (gcs_api_key and gcs_engine_id): discontinued on January 1, 2027

On the Cloud edition, rankings are measured with the search included with Cloud (Serper.dev), with no key needed. Enter your own DataForSEO credentials and you can also pick DataForSEO in "Data Source Selection" (since 2.137.0; you pay DataForSEO directly). Until the credentials are set, rankings keep using the search included with Cloud even if DataForSEO is selected.

Which one should you use? (search_provider)

The Search Data Source dropdown on the same screen decides where Sorabun goes to fetch rankings. The default is "Auto," and that's fine to leave as is.

"Auto" uses whichever keys you've entered, in the order Serper.dev, then SerpApi, then Google Custom Search. If you've only entered a Serper.dev key, that's what gets used. If you later add a SerpApi key too, Serper.dev still takes priority.

"Auto" never picks DataForSEO. Because it costs money, Sorabun uses it only when you choose DataForSEO in the dropdown. Entering your DataForSEO credentials for search volume alone does not make the rank check use it.

Only choose one manually in cases like these:

  • You've entered both keys and want to use the one that isn't prioritized
  • You've used up one service's free quota and want to switch to the other
  • You want to narrow down why rankings aren't being fetched
When choosing manually, make sure that key is actually entered

Choose anything other than "Auto" and Sorabun will use only the one you specified. If you choose a service you haven't entered a key for, rankings won't be fetched even if other keys are set. The screen will show "Not configured."

Google Custom Search ends on January 1, 2027

Google's Custom Search JSON API no longer accepts new customers and will be discontinued on January 1, 2027 (Google's notice). Don't choose it if you're just getting started.

Sites that use Custom Search (including sites where "Auto" ends up on Custom Search) see a notice on the "Search Data Source" section of the Settings screen and on the rank check screen, saying that it will end and listing where to move (Serper.dev, SerpApi or DataForSEO). Switching over is as simple as entering a key and changing the dropdown, and the ranking history you've measured up to that point stays intact.

From January 1, 2027, Sorabun stops calling Custom Search (a call would only fail). "Auto" no longer picks it, choosing it manually counts as "Not configured," and both screens say that it has stopped. Until you switch, the daily rank check stays stopped, and competitor analysis and keyword vetting while writing articles go ahead without the top search results.

Measuring with DataForSEO (mobile, by city, down to position 100)

Choose DataForSEO in the dropdown and Sorabun fetches rankings through DataForSEO's standard queue, the cheapest way to get them. Unlike Serper.dev and the others, the answer does not come back right away.

  1. The daily rank check sends your keywords to DataForSEO (up to 100 per request)
  2. A few minutes later, Sorabun reads the finished results (usually about 5 minutes, up to about 45 when it's slow). Reading them is free
  3. Until they arrive, the rank check screen shows "Waiting for results." Clicking "Check now" works the same way: open the screen again a few minutes later and the result is there

Rankings are counted among organic results only (AI Overviews and "People also ask" boxes don't count). Google redirect links are turned back into the real page before Sorabun checks whether the result is your site. Citations in AI Overviews and the competitor domains on page 1 are read from the same response, just as before.

Choosing how to measure (Settings > Search Data Source > Rankings measured with DataForSEO)

ItemSetting keyChoicesDefault
Devicerank_deviceDesktop, mobile, or both (costs twice as much)Desktop
Locationrank_dfs_locationBlank for all of Japan. You can go down to a city or wardAll of Japan
How deep to lookrank_dfs_depth10 to 100 (in steps of 10)30
Keywords per dayrank_dfs_daily10 to 1,00030

Write the location in English, exactly as in DataForSEO's list of locations. The field suggests the prefectures, the designated cities and Tokyo's 23 wards.

  • Shibuya Ward: Shibuya,Tokyo,Japan
  • Osaka City: Osaka,Osaka,Japan
  • Tokyo Prefecture: Tokyo,Japan

You can also enter the number from the list (the location_code, 1009308 for Shibuya). If the format is wrong, Sorabun doesn't save it and keeps the previous value.

The device and location are one setting for the whole site (not per keyword). A ranking is measured for "where and on what your readers search," which is normally one thing per site. Setting them per keyword would make keywords impossible to compare (the list's order, the dashboard's "number in the top 10" and the AI Editor-in-Chief's judgments would mix rankings measured under different conditions). It also keeps the cost estimate a simple multiplication.

Choose "Desktop and mobile" and "Current rank" shows the desktop ranking, while the mobile ranking appears in the new "Device" column. Choose "Mobile" alone and "Current rank" becomes the mobile ranking. It isn't compared with an earlier desktop measurement (the change and the best rank only compare the same device).

Second reads

Google sometimes returns search results that leave out sites that really rank. On top of DataForSEO's own fix (resolve_poisoned_results), Sorabun reads these once more and keeps the better ranking:

  • Keywords that ranked last time but are out of range this time
  • Keywords DataForSEO didn't answer (the task failed)

Keywords that were out of range last time too are not read again, and no second read is added to a result that arrived more than an hour after it was requested. Anything that hasn't arrived 3 hours after the request is given up and moved to the next day. In that case neither the ranking nor the "Last checked" date changes, so the keyword is picked first in the next day's rank check.

Cost

DataForSEO's price (November 2026) is $0.0006 per page of results (10 results) in the standard queue. One keyword, one check costs the sum of:

  • Pages looked at x $0.0006 (3 pages for 30 positions, rounded up in steps of 10)
  • +$0.0006 for fixing poisoned results (every time)
  • +$0.0006 for reading the AI Overview (refunded by DataForSEO when no overview appears)

Down to position 30, that's about $0.003 per keyword per check, and at most $0.006 with a second read. DataForSEO's pricing page charges the pages after the first at the same price, while actual bills have been reported at about 75%. The estimate uses the higher figure (the same price). Keywords that contain a search operator such as site: cost five times as much for the pages.

The Settings screen and the rank check screen show the estimate for one check and for a month (number of keywords x devices x depth x every day). For example, 30 keywords, desktop only, down to position 30 comes to about $2.70 a month ($5.40 if every keyword needed a second read). The rank check screen also shows how many keywords were sent today and what that cost (the amount DataForSEO reported).

There is a daily limit on keywords (30 by default), and anything over it moves to the next day. Clicking "Check now" doesn't go over the limit either. You can raise the limit up to 1,000 keywords in Settings (the 30-keyword limit for Serper.dev and the others doesn't change).

When DataForSEO fails (wrong login, insufficient balance, a misspelled location and so on), the rank check screen shows the reason.

This way of fetching (sending to the standard queue and reading later, second reads, and the cost estimate) is based on the design of the open-source SEO tool OpenSEO (MIT License, (c) 2026 Ben Senescu), rebuilt to run inside WordPress.

Using real data from Search Console

Install and connect the free Google Site Kit plugin, and Sorabun can pull in impressions, clicks, and average position at no extra cost. These numbers are closer to reality than the SERP API's estimates.

Showing search volume

Set up a DataForSEO account (dataforseo_login / dataforseo_password) and Sorabun displays the monthly search volume for each keyword (this works whether or not you choose DataForSEO for rankings). Retrieved values are cached for 30 days, keeping API costs down.

Next steps

For articles whose rankings aren't improving, you can improve them from SEO Insights and Rewriting.