SEO-проекты · token

`urls` Целевые URL запросов проекта

Отдаёт список целевых URL, привязанных к запросам проекта, — страниц, которые продвигаются по этим запросам. Каждый URL встречается один раз. Метод синхронный.

Адрес: /projects/api/v1/urls/get
Режим: синхронный
Лимиты: не тратит

Список целевых URL

GET /projects/api/v1/urls/get

Целевой URL задаётся запросу в интерфейсе проекта или параметром url в queries/set. Какие запросы ведут на какой URL, этот метод не показывает — только сам список адресов.

Параметры query

token string обязательный

Ключ API из настроек аккаунта — тот же, что key у методов инструментов.
project_id int обязательный

ID проекта. Виден в адресе страницы проекта и в ответе projects/get.

Ответ

Массив строк без обёртки status/result. Если у части запросов целевой URL не задан, в списке будет пустая строка или null.

GET /projects/api/v1/urls/get

curl -G 'https://tools.pixelplus.ru/projects/api/v1/urls/get' \
  --data-urlencode 'token=ВАШ_КЛЮЧ' \
  --data-urlencode 'project_id=7002'

<?php
$url = 'https://tools.pixelplus.ru/projects/api/v1/urls/get?' . http_build_query([
    'token' => 'ВАШ_КЛЮЧ',
    'project_id' => 7002,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/projects/api/v1/urls/get",
    params={
        "token": "ВАШ_КЛЮЧ",
        "project_id": 7002,
    },
    timeout=60,
)
print(response.json())

project_id обязательный ID проекта. Виден в адресе страницы проекта и в ответе projects/get

Запрос настоящий — выполнится с вашим ключом

Пример ответа

[
    "https://example.ru/",
    "https://example.ru/catalog/",
    "https://example.ru/delivery/",
    ""
]

Ошибки

Код	Сообщение	Когда
`50`	`access error`	Токен не передан, не найден, или у его владельца нет доступа к проекту.

Ответ с ошибкой

{
    "status": "error",
    "code": 50,
    "msg": "access error",
    "result": []
}