Методы API
Список методов

Поиск в социальной сети ВК

Основные параметры запроса:

key
Ключ доступа к API
method
Вызываемый метод

Поиск профилей в социальных сетях по номеру телефона

phone
Номер телефона

Примеры запроса:

PHP
Python
C#
                        
// Входные данные
$url = "https://data.av100.ru/socialapi.ashx";
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "byphone",
    "phone" => "79999999999"
);

$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params);
// Преобразование ответа
$result = json_decode($response);
                        
                    
                        
import requests

url = "https://data.av100.ru/socialapi.ashx"

# подготовка параметров get запроса
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "phone": 79999999999,
    "method": "byphone"
}

# отправка запроса
response = requests.get(
    url=url,
    params=params
)

# преобразование ответа к словарю
data = response.json()
                        
                    
                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.av100.ru/socialapi.ashx";
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "phone", "79999999999" },
            { "method", "byphone" }
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = ${end_point}?{url_params}";

        HttpClient client = new();
        string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}
                        
                    

Результат вызова метода:

Описание возвращаемого JSON

start DateTime
Дата и время создание запроса
end DateTime
Дата и время окончания запроса
method String
Используемый метод обращения в запросе
phone String
Номер телефона по которому запрашивается информация
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
result Object
Объект с результатом возвращаемого запроса
name String
Имя пользователя
type String
Социальная сеть (например “vk”)
id String
Идентификатор пользователя
photo String
Ссылка на фото

Результат вызова метода в случае ошибки:

  • Закончился доступ или запросы (Проверить доступ)

  • Нет необходимых прав

  • Некорректный ключ доступа или пользователь не создан

  • Номер телефона не указан

  • Номер телефона в недопустимом формате
  • Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Используемый метод обращения в запросе
    phone String
    Номер телефона по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки

    Поиск профилей в социальной сети ВК по изображению

    img
    Изображение в формате base64

    Примеры запроса:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.ru/socialapi.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "byphoto"
    );
    
    // Подготавливаем изображение
    $filename = "image.jpg";
    $img = file_get_contents($filename);
    $data = base64_encode($img);
    
    // Готовим заголовок и тело запроса
    define('MULTIPART_BOUNDARY', '--------------------------'.microtime(true));
    define('FORM_FIELD', 'img');
    $header = 'Content-Type: multipart/form-data; boundary='.MULTIPART_BOUNDARY;
    $content =  "--".MULTIPART_BOUNDARY."\r\n".
    "Content-Disposition: form-data; name=\"".FORM_FIELD."\"".
    "\r\n\r\n".$data."\r\n"."--".MULTIPART_BOUNDARY."--\r\n";
    
    $context = stream_context_create(array(
        'http' => array(
              'method' => 'POST',
              'header' => $header,
              'content' => $content,
        )
    ));
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params, false, $context);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    import base64
    
    
    url = "https://data.av100.ru/socialapi.ashx"
    img_path = "image.jpg"
    
    # готовим изображение
    with open(img_path, 'rb') as img_content:
        img_enc = base64.b64encode(img_content.read()).decode('utf-8')
    
    # подготовка параметров url запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method": "byphoto"
    }
    
    # отправка запроса
    response = requests.post(
        url=url,
        params=params,
        files={'img': (None, img_enc)}
    )
    
    # преобразование ответа к словарю
    data = response.json()
                            
                        
                            
    using Newtonsoft.Json;
    class Program
    {
        static async Task Main(string[] args)
        {
            string end_point = "https://data.av100.ru/socialapi.ashx";
            string path_img = "img.jpg";
            byte[] img_bytes = System.IO.File.ReadAllBytes(path_img);
            string base64_img = Convert.ToBase64String(img_bytes);
            HttpContent data_img = new StringContent(base64_img);
    
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "method", "byphoto" }
            };
    
            string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
            string url = ${end_point}?{url_params}";
    
            HttpClient client = new();
            MultipartFormDataContent form_data = new();
            form_data.Add(data_img, "img");
    
            string response_body = await client.PostAsync(url, form_data).Result.Content.ReadAsStringAsync();
    
            var result = JsonConvert.DeserializeObject(response_body);
        }
    }
                            
                        

    Результат вызова метода:

    Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Используемый метод обращения в запросе
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    result Array
    Массив с результатом возвращаемого запроса

    Результат вызова метода в случае ошибки:

  • Закончился доступ или запросы (Проверить доступ)

  • Нет необходимых прав

  • Некорректный ключ доступа или пользователь не создан
  • Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Используемый метод обращения в запросе
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки

    Поиск номера телефона по профилю социальной сети ВК

  • В качестве параметра может быть передан идентификатор профиля или ссылка на профиль
  • vkid
    ID профиля VK
    url
    URL адрес профиля VK

    Примеры запроса:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.ru/socialapi.ashx";
    
    // Подготовка параметров get запроса по id профиля
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "byvkprofile",
        "vkid" => 000000000
    );
    
    // Подготовка параметров get запроса по url профиля
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "byvkprofile",
        "url" => "http://vk.com/id0000000"
    );
    
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    
    url = "https://data.av100.ru/socialapi.ashx"
    
    # подготовка параметров get запроса по id профиля
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method": "byvkprofile",
        "vkid": 000000000
    }
    
    # подготовка параметров get запроса по url профиля
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method": "byvkprofile",
        "url": "http://vk.com/id0000000"
    }
    
    # отправка запроса
    response = requests.post(
        url=url,
        params=params,
    )
    
    # преобразование ответа к словарю
    data = response.json()
                            
                        
                            
    using Newtonsoft.Json;
    class Program
    {
        static async Task Main(string[] args)
        {
            string end_point = "https://data.av100.ru/socialapi.ashx";
    
            // Подготовка параметров get запроса по id профиля
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "vkid", "000000" },
                { "method", "byvkprofile" }
            };
    
            // Подготовка параметров get запроса по url профиля
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "url", "http://vk.com/id0000000" },
                { "method", "byvkprofile" }
            };
    
            string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
            string url = ${end_point}?{url_params}";
    
            HttpClient client = new();
            string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();
    
            var result = JsonConvert.DeserializeObject(response_body);
        }
    }
                            
                        

    Результат вызова метода:

    Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Используемый метод обращения в запросе
    vkId String
    Идентификатор пользователя ВК по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    result String
    Результат возвращаемого запроса, содержащий номера телефонов разделенные запятыми

    Результат вызова метода в случае ошибки:

  • Закончился доступ или запросы (Проверить доступ)

  • Нет необходимых прав

  • Некорректный ключ доступа или пользователь не создан

  • Идентификатор не указан
  • Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Используемый метод обращения в запросе
    vkId String
    Идентификатор профиля ВК по которому запрашивается информация
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    error_msg String
    Сообщение с описанием ошибки