API - поиск по номеру телефона

Чтобы совершить поиск вам нужно:

  1. Создать задание методом create
  2. Подождать несколько секунд чтобы задание было успешно обработано.
  3. Запросить результат методом result. Если задание еще обрабатывается, перейти к п.2.

Дополнительные методы:

  • Получить актуальную информацию по аккаунту методом info
Запустите новую задачу с помощью метода create (GET, POST):

выполняется на адрес https://i-find.pro/api/create

Параметр Обязательный Описание
login да Логин пользователя в системе, e-mail
token да Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API"
phone да Телефон начиная с кода страны без знака "+", по которому требуется фильтрация. Выводит информацию с этим телефоном. (минимум спишет 1 ед. с суточного лимита)
source да поиск по артикулу: 41 - ozon (поиск по артикулу); 3 - whatsapp (по запросу)), 11 - доски объявлений KZ (olx), 12 - доски объявлений BY (kufar)
format нет (json) Формат ответов. Возможные значения: json, xml, csv

Пример создания задачи для поиска объявлений OLX.kz по номеру телефона:

https://i-find.pro/api/create?login=email@domain.ru&token=api_key&phone=77021875006&source=11

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

{
    "status": "ok",
    "id": 123
}

Запросы результата с помощью метода result (GET, POST):

выполняется на адрес https://i-find.pro/api/result

Параметр Обязательный Описание
login да Логин пользователя в системе, e-mail
token да Access token, используемый для авторизации. Выдается на этой странице в разделе "Подключение к API"
id да Идентификатор задачи, выданный методом create
format нет (json) Формат ответов. Возможные значения: json, xml, csv

Пример запроса результата:

https://i-find.pro/api/result?login=email@domain.ru&token=api_key&id=123

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

{
    "status": "processing"
}

или

{
    "status": "ready",
    "data": [
                {
                    "title": "Заголовок",
                    "price": "Цена",
                    "time": "Дата время",
                    "phone": "Номер",
                    "name": "Ник",
                    "description": "Описание",
                    "location": "Адрес",
                    "source": "Источник"
                    "category": "Категория",
                    "url": "Ссылка",
                },
                {
                    "title": "Заголовок",
                    "price": "Цена",
                    "time": "Дата время",
                    "phone": "Номер",
                    "name": "Ник",
                    "description": "Описание",
                    "location": "Адрес",
                    "source": "Источник"
                    "category": "Категория",
                    "url": "Ссылка",
                }
        ],
    "cost": "затраты / стоимость",
    "ip": "адрес с которого была создана задача",
    "create_time": время создания,
    "end_time": время завершения,
}

Пример ошибки:

{
    "status": "error",
    "error_code": 400,
    "message": "Not set param(s) login, token"
}