Search Console

Optimize your existing articles to rank on more keywords, and bring in more traffic

Byword's Search Console integration allows you to analyse the keywords that your existing pages rank on, and generate new pieces of content to improve your rankings.

Get started

To get started, head to this page.

Clicking the button there will allow you to authenticate via you Google account. Make sure to select a Google account which has access to the Search Console properties you'd like to pull data from.

When you're asked to give Byword access to the following permissions, make sure both are ticked before continuing.

Once you've shared Google access to your Search Console account, you'll be taken to the main dashboard:

By default, you'll be in page mode, which lets you see all the pages on your site. Clicking 'Queries' at the top of the table, or 'Analyse' next to a specific page, will show query-level data.

This is where things start to get interesting!

You'll want to look for queries where you're not ranking at the top of the page (i.e. your 'Position' is perhaps 2.0 or lower) and where there's traffic. A query like this represents an opportunity to optimise your article by adding relevant content. Byword will help you generate relevant content when your press the 'Generate' button, which you can add to your article to help it rank better.

Once we've found a query that we'd like to improve our ranking on, we can hit 'Generate', and the generation screen will come up:

Here, Byword has generated a paragraph that can help our page ( rank better on the keyword 'ai blog title generator'. Including this text on our page (which we can do with the 'Copy Text' button, should help us rank better on this keyword.

Advanced Usage

The above covers the basics of how to use Byword's Search Console integration, but there are some things to keep in mind if you'd like to get more out of the feature:

  • Generation Modes You can toggle what type of text Byword generates by using the dropdown at the top right of the table on the Search Console page. You can choose between:

    • Sentences A single sentence; short and to the point!

    • Paragraphs A medium length paragraph - designed to give a bit more material for Google to work with.

    • Sections A much larger piece of text, which will typically consist of an H2, two H3s, and paragraph text surrounding them.

    • Snippets Shorter pieces of content, often in list format, designed to help you win featured snippets.

  • Re-Generation Don't like what Byword's generated? You can add some feedback into the box at the bottom of the generation screen and hit 'Re-Generate'. Byword will produce another generation with your feedback in mind. You can do this as many times as you like without using up generations.

There is also a 'Settings' button at the top of the page which lets you do certain things:

  • Language Model You can tweak whether you'd like to use GPT3.5 (which will be significantly faster) or GPT4 (slower, but with higher quality).

  • Copy Mode Changing this will affect what gets copied to your clipboard when you hit 'Copy Text' on a generation. You'll generally want this to match whatever your CMS uses.

  • Language The language that Byword generates text in. Note that this is synced to the language that you generate articles in - making a change on this page will also affect the language articles are generated in.

  • Reset Integration Problems with your integration? Didn't give Byword the necessary permissions? This can often be fixed by resetting the integration and starting again.


Byword currently doesn't have any way of integrating the generations into your article automatically (watch this space though). The easiest way to export your content generations is to hit the 'History' screen at the top of the page, and either copy/paste generations manually, or use the 'Download as CSV' button.

Plans & Billing

How does this work? Does this cost? Does this use up my article credits?

The Search Console integration uses an entirely separate system from regular article credits: generating a piece of content via the Search Console page does not use an article credit in the same way that generating a new article would.

Instead, each plan comes with a certain number of generations per month:

  • No plan - 3 generations/month

  • Starter - 25 generations/month

  • Standard - 80 generations/month

  • Scale - 300 generations/month

  • Unlimited - unlimited generations (but run off of your provided API key)

On regular plans, you'll never be charged based on Search Console usage/how much you generate. Simply think of this as a bonus feature that's included in your plans.


What's the opportunities tab?

This is the same as the unfiltered queries tab (showing you pairs of queries and pages) except that it's filtered for positions between 3.0 and 10.0. The idea here is that these are queries which your pages are ranking decently on, but where you have the opportunity to get into the top spots with a little bit of optimisation. You don't have to use this tab at all, but it can give some good ideas of where to get started!

How much does this cost?

Nothing - see the Plans & Billing section above.

Users on the Unlimited plan will incur costs on their API keys, however these are likely to be extremely small. Feel free to contact for more details.

I can't see anything...

Did you grant Byword relevant permissions on authentication (when you were asked to log in with Google)?

Did you authenticate with an account that definitely has access to at least one Search Console property (with traffic)?

Your best bet is to navigate to 'Settings' (at the top of the page) and then reset the integration, checking both of the above.

Last updated