In this section, we will cover how to query SEO data from Botify.
To know when you should use exports instead of queries, see the related guide.
Any SEO data at Botify is retrieved through our own query language: BQL, short for Botify Query Language, a custom JSON DSL.
Querying data is no exception and uses BQL to express what data you are trying to fetch. BQL and its possibilities are documented exhaustively in this section.
Querying through this API allows you to fetch up to 2000 rows of data in one call in just a few seconds. The API can be used to test out your BQL query before making an export out of it, or to fetch data quickly without overhead.
The most important aspects are:
- get access credentials: your username, project slug and API token. Getting started will explain you how to get your information.
POSTquery to the URL
- write your BQL query
And you should be good to go.
To make your first BQL API call, see the How-to: BQL API call.
The BQL endpoint takes two headers:
Authentication: Token <YOUR_TOKEN>
The endpoint also takes three optional query params:
size: the number of results by page. By default
page: the number page. By default
count: the total number of results. If specified, the API response will contain a
countkey with the total number of results. By default not specified.
Updated almost 3 years ago