SERP API

Search Engine

This API is used to get the number of keywords in TOP-100 of each search engine. The "id" stands for the search engine ID, and the "cnt" indicates the number of keywords in TOP-100.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/search-engine/top site, date, size Get TOP Search Engine for site

Parameters description:

1. site * (required) - domain name

2. date * (required) - date-specific values

3. size - count of items in response

4. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/search-engine/top?site=kwinside.com&date=2020-08-20&key=example


This API is used to get a full list of search engines.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/search-engine/list - Get list of search engines

Keywords

This API is used to obtain the number of keywords in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the required domain and search engine as of the specified date range.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/keywords/tops site, se, sub, dates Keywords tops

Parameters description:

1. site * (required) - domain name

2. se * (required) - search engine ID

3. dates * (required) - comma-separated dates: 2019-09-02,2019-09-09

4. sub - with subdomains (available values: 0, 1)

5. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/keywords/tops?site=kwinside.com&se=1&sub=1&dates=2020-01-01,2020-05-05&key=example


This API is used to obtain a list of keywords with corresponding positions for the required domain and search engine as of the specified date range.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/keywords/list site, se, sort_type, sort_date, top_filter, sort_by, pos_filter Keywords list with positions

Parameters description:

1. site * (required) - domain name

2. se * (required) - search engine ID

3. sort_date * (required) - available values: asc, desc (default value: desc)

4. dates - comma-separated dates: 2019-09-02,2019-09-09

5. sort_type - available values: asc, desc (default value: desc)

6. size and offset - use these parameters to set the exact count of keywords in response and pagination

7. top_filter - available values : 1, 3, 10, 30, 50, 100 (default value : 100)

8. kw_filter_type - available values: match

9. kw_filter - filter keyword

10. page_filter_type - available values: match

11. page_filter - filter page

12. sort_by - available values: pos, kw, py (default value: pos)

13. pos_filter - available values: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter (default value: all)

14. add_null - available values: true, false

15. sub - with subdomains (available values: 0, 1)

16. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/keywords/list?site=kwinside.com&se=1&sort_type=desc&sort_date=1&top_filter=100&sort_by=pos&pos_filter=all&key=example


This API is used to obtain a list of competitor sites for any keyword and search engine as of the specified date range.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/keywords/competitors se, dates, size, offset, top_filter, kw_filter competitors’ keywords

Parameters description:

1. se * (required) - search engine ID

2. dates * (required) - comma-separated dates: 2019-09-02,2019-09-09

3. size and offset - use these parameters to set the exact count of keywords in response and pagination

4. kw_filter - filter keyword

5. top_filter - available values : 1, 3, 10, 30, 50, 100 (default value : 100)

6. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/keywords/competitors?se=1&kw_filter=seo&dates=2020-01-01%2C2020-08-25&size=10&top_filter=100&key=example


Best Pages

This API is used to get the number of keywords in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the best pages of the given site and search engine as of the specified date range.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/best-pages/tops site, se, dates TOP best pages

Parameters description:

1. site * (required) - domain name

2. se * (required) - search engine ID

3. dates * (required) - comma-separated dates: 2019-09-02,2019-09-09

4. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/best-pages/tops?site=kwinside.com&se=1&dates=2020-01-01%2C2020-05-05&key=example


This API is used to get a list of the best pages of a particular domain for the required search engine and date range.

HTTP Method URL Parameters Description
GET https://kwinside.com/api/v1/serp/best-pages/list site, se, dates, top_filter, sort_type, pos_filter TOP best pages

Parameters description:

1. site * (required) - domain name

2. se * (required) - search engine ID

3. dates * (required) - comma-separated dates: 2019-09-02,2019-09-09

4. size and offset - use these parameters to set the exact count of keywords in response and pagination

5. top_filter - available values : 1, 3, 10, 30, 50, 100 (default value : 100)

6. sort_type - available values: asc, desc (default value: desc)

7. pos_filter - available values: all, not_positions, changed, not_changed, moved_up, moved_down, entered, dropped, all_filter (default value: all)

8. sort_date * (required) - sort date, e.g.: 2020-05-05

10. page_filter_type - available values: match

11. page_filter - filter page

12. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/best-pages/list?site=kwinside.com&se=1&dates=2020-01-01%2C2020-05-05&top_filter=100&sort_type=desc&pos_filter=all&key=example


This API is used to get the number of the best pages in TOP-1, TOP-3, TOP-10, TOP-30, TOP-50, and TOP-100 for the given site and its list of pages for the specified date range and search engine.

HTTP Method URL Parameters Description
POST https://kwinside.com/api/v1/serp/best-pages/tops_by_pages site, se, dates, top_filter, pages TOP best pages by pages

Parameters description:

1. site * (required) - domain name

2. se * (required) - search engine ID

3. dates - comma-separated dates: 2019-09-02,2019-09-09

4. top_filter - available values : 1, 3, 10, 30, 50, 100 (default value : 100)

5. pages[] * (required) - pages, array[string].

6. key * (required) - an API key that you can get in your account

Sample of a URI request: https://kwinside.com/api/v1/serp/best-pages/tops_by_pages?site=kwinside.com&se=1&dates=2020-01-01%2C2020-05-05&top_filter=100&pages[]=/pricing&key=example