tapki.com

API

Select the query type to see an example request and test response. API requests fail.

GET https://tapki.com/api/v1/landing?query=example.comX-Api-Key: tap_q3Yb7LxR2mVd9KsA4TfH6JnP0WcE8ZuG1iOy5NrDmKq

Response structure

FieldTypeDescription
info{ } | nullMain information.
├ titlestring | nullTitle: website title or organization name.
├ descriptionstring | nullDescription.
├ categoriesstring[]Categories: activity codes, rubric titles, etc.
└ statusnumber | nullStatus: a numeric code, values are listed below.
├ = 1Available: the object data can be fetched.
├ = 2Not available: the object data cannot be fetched.
├ = 3Active: registered and operating.
├ = 4Liquidating: the object is being liquidated.
├ = 5Liquidated: the object has ceased operations.
├ = 6Bankrupt: bankruptcy proceedings are open against the object.
├ = 7Reorganizing: the object is being reorganized.
├ = 8Permanently closed: the object no longer operates.
└ = 9Open: the object is operating.
rating{ } | nullRating and reviews.
├ ratingnumber | nullAverage rating.
├ reviewCountnumber | nullReview count.
└ aspects[ { } ]Review aspects.
├ idstring | nullAspect identifier.
├ namestring | nullAspect name.
├ countnumberTotal reviews for the aspect.
├ positivenumberPositive reviews for the aspect.
├ neutralnumberNeutral reviews for the aspect.
└ negativenumberNegative reviews for the aspect.
contacts{ } | nullContacts.
├ emailsstring[]Email addresses.
├ phoneNumbersstring[]Phone numbers.
└ socials{ } | nullSocial networks.
├ vkLinksstring[]VK links.
├ telegramLinksstring[]Telegram links.
├ okLinksstring[]Classmates links.
├ instagramLinksstring[]Instagram links.
├ youTubeLinksstring[]YouTube links.
├ facebookLinksstring[]Facebook links.
├ whatsAppLinksstring[]WhatsApp links.
├ viberLinksstring[]Viber links.
├ dzenLinksstring[]Zen links.
├ tikTokLinksstring[]TikTok links.
├ twitterLinksstring[]Twitter links.
├ maxLinksstring[]MAX links.
└ rutubeLinksstring[]Rutube links.
legal[ { } ] | nullLegal entities.
├ innstring | nullTIN.
├ ogrnstring | nullOGRN.
├ kppstring | nullKPP.
├ organizationNamestring | nullOrganization name.
├ ogrnDatestring | nullOGRN registration date.
├ statusnumber | nullOrganization status: the same codes as in info.status.
├ employeeCountnumber | nullEmployee count.
├ okvedstring | nullMain OKVED activity code.
├ okvedTypestring | nullOKVED reference version.
├ citizenship{ } | nullCitizenship: country of registration.
│ ├ codestring | nullCountry numeric code.
│ ├ alpha3string | nullCountry letter code (ISO 3166-1 alpha-3).
│ ├ namestring | nullCountry name.
│ └ shortNamestring | nullCountry short name.
├ taxSystemstring | nullTaxation system.
├ financeYearnumber | nullFinancial reporting year.
├ incomenumber | nullIncome.
├ revenuenumber | nullRevenue.
├ expensenumber | nullExpense.
├ debtnumber | nullDebt.
├ penaltynumber | nullPenalty.
├ capitalTypestring | nullCapital type.
├ capitalValuenumber | nullCapital amount.
└ scorenumber | nullCandidate match score: confidence in the range (0, 1] that it belongs to the same business.
websites[ { } ] | nullWebsites.
├ domainstring | nullDomain.
├ titlestring | nullWebsite title.
└ scorenumber | nullDomain confidence score in the range (0, 1]; null when the domain is not scored.
geo{ } | nullGeography.
├ citystring | nullCity.
├ addressstring | nullAddress.
├ otherCitiesstring[]Other branch cities.
└ otherAddresses[ { } ]Other branch addresses.
├ valuestring | nullBranch address.
├ citystring | nullBranch address city.
├ latitudenumber | nullLatitude.
└ longitudenumber | nullLongitude.

Example response

{
  "info": {
    "title": "Пример компании — разработка программного обеспечения",
    "description": "Разработка программного обеспечения и сопровождение информационных систем.",
    "categories": [
      "Разработка программного обеспечения",
      "ИТ-консалтинг"
    ],
    "status": 1
  },
  "rating": {
    "rating": 4.8,
    "reviewCount": 1257,
    "aspects": [
      {
        "id": "3502044648",
        "name": "Бассейн",
        "count": 583,
        "positive": 370,
        "neutral": 140,
        "negative": 73
      },
      {
        "id": "3502044742",
        "name": "Номера",
        "count": 510,
        "positive": 297,
        "neutral": 76,
        "negative": 137
      }
    ]
  },
  "contacts": {
    "emails": [
      "info@example.com",
      "support@example.com"
    ],
    "phoneNumbers": [
      "+78127482096",
      "+74952155316"
    ],
    "socials": {
      "vkLinks": [
        "vk.com/example_company"
      ],
      "telegramLinks": [
        "t.me/example_company"
      ],
      "okLinks": [
        "ok.ru/example_company"
      ],
      "instagramLinks": [
        "instagram.com/example_company"
      ],
      "youTubeLinks": [
        "youtube.com/@example_company"
      ],
      "facebookLinks": [
        "facebook.com/example_company"
      ],
      "whatsAppLinks": [
        "wa.me/78127482096"
      ],
      "viberLinks": [
        "viber.com/example_company"
      ],
      "dzenLinks": [
        "dzen.ru/example_company"
      ],
      "tikTokLinks": [
        "tiktok.com/@example_company"
      ],
      "twitterLinks": [
        "x.com/example_company"
      ],
      "maxLinks": [
        "max.ru/example_company"
      ],
      "rutubeLinks": [
        "rutube.ru/channel/example_company"
      ]
    }
  },
  "legal": [
    {
      "inn": "7813229833",
      "ogrn": "1157847301853",
      "kpp": "781001001",
      "organizationName": "ООО «Реформа»",
      "ogrnDate": "2015-09-03T00:00:00Z",
      "status": 3,
      "employeeCount": 25,
      "okved": "62.01",
      "okvedType": "2014",
      "citizenship": {
        "code": "643",
        "alpha3": "RUS",
        "name": "Российская Федерация",
        "shortName": "Россия"
      },
      "taxSystem": "USN",
      "financeYear": 2025,
      "income": 1324000,
      "revenue": 1324000,
      "expense": 751000,
      "debt": 12500,
      "penalty": 340,
      "capitalType": "Уставный капитал",
      "capitalValue": 20000,
      "score": 0.98
    }
  ],
  "websites": [
    {
      "domain": "example.com",
      "title": "Пример компании — разработка программного обеспечения",
      "score": 1
    }
  ],
  "geo": {
    "city": "Санкт-Петербург",
    "address": "Санкт-Петербург, Чистяковская улица, 2",
    "otherCities": [
      "Москва"
    ],
    "otherAddresses": [
      {
        "value": "Москва, Тверская улица, 7",
        "city": "Москва",
        "latitude": 55.7649,
        "longitude": 37.6054
      }
    ]
  }
}