We’ve added a possibility to sort and filter results by the number of intersections in the Page Intersection and Domain Intersection endpoints of Backlinks API.
For example, now you can apply the following settings when making calls to these endpoints:
"order_by": [ "intersections_count,desc"]
"filters": [ "intersections_count", "<=", 2 ]
In view of this change, we’ve also updated the response structure.
For Page Intersection, we’ve added a page_intersection object that contains data on pages that link to the corresponding targets you specify when setting a task. Besides that, we’ve added a summary object that contains data on the total number of intersections for the related page_intersection object.
Here’s what it looks like:
{
"version": "0.1.20221214",
"status_code": 20000,
"status_message": "Ok.",
"time": "14.9959 sec.",
"cost": 0.02015,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03211912-1535-0287-0000-fd766e2cbfdc",
"status_code": 20000,
"status_message": "Ok.",
"time": "14.9372 sec.",
"cost": 0.02015,
"result_count": 1,
"path": [...],
"data": {...},
"result": [
{
"targets": {...},
"total_count": 123,
"items_count": 5,
"items": [
{
"page_intersection": {
"1": [
{
"type": "backlinks_page_intersection",
...}
],
"2": [
{...}
],
"summary": {
"intersections_count": 2
}
}
]
}
]
}
]
}
Similarly, for Domain Intersection endpoint, we’ve added a domain_intersection object that contains data on domains that link to the corresponding targets you specify when setting a task. This endpoint now also has a summary object that contains data on the total number of intersections for the related domain_intersection object.
Please, refer to our docs to review the new sorting and filtering rules and check out the updated structure of API responses.