Updated 13 March 2020 by Max
h2 style=”text-align: left;”>The SERPmetrics API Review
How it works
The SERPmetrics API allows programmatic access to provision, collect and analyze SERP data from our core systems. The API requires authentication (see below) and, in turn, grants access to the following workflow:
[dt_vc_list style=”2″ bullet_position=”middle”]
- You add keywords to the daily queue. Once added, keywords will continue to be checked every 24hrs until removed.
- You request SERP data in one of the following ways:
We can send an HTTP POST to a pre-specified URL to inform you when new data is available for a keyword/engine combination (recommended).You can periodically poll the API to check for new data
– note: you can choose to receive the full top 100 results or only those related to a specific root domain.
- You can optionally request trended historical data for a keyword + domain/url
- You analyze the requested JSON data within your own backend
– See more at: https://serpmetrics.com/docs/#sthash.Os7clMNZ.dpuf
- Engine – we refer to an engine as a specific engine/locale combination. An engine is always referred to by it’s engine_code – a combination of it’s parent engine code and locale separated by an underscore. For example google_en-us or yahoo_en-gb.
- Parent engine – the top level engine, for example Google, Yahoo! or Bing.
Flux – when we pull a new SERP, we compare it to the last version we have on record (normally from 24hrs before). We use a unique scoring system that calculates movement/turbulence within the top 100 results – weighted towards the top end – and assign a score to each URL. The flux metric is a sum of all URL scores for a SERP. The average flux scores of all SERPs make up our hourly and daily flux graphs.
- Keyword pair – we often refer to a keyword pair. This is simply a keyword/engine combination and forms the basis of our pricing structure.
- Callback URI – when we create your API account, you can supply us with your own endpoint to receive notification callbacks. We simply send a POST request to your callback URI whenever we have new data for you. This means you don’t have to poll and incur extra API credit fees and also has the added benefit of having the data immediately available to you
The majority of our documentation is very straight forward, however there is some terminology that requires clarification: