The Tinq.AI article extractor is a tool that allows extracting various elements of a given URL. It can be tried on our website https://tinq.ai for free.

Updated documentation here

Endpoint:

POST <https://tinq.ai/api/v1/extract-article>

Here is a sample cURL request:

curl -X "POST" "<http://scribe.test/api/v1/extract-article>" \\
     -H 'Content-Type: multipart/form-data; charset=utf-8' \\
     -F "api_key={YOUR_API_KEY}" \\ # (required) API key
     -F "username={YOUR_API_USERNAME}" \\ # (required) API username
     -F "extract_url=https://otimbi.com" \\ # (required) URL to fetch
     -F "lang=english" # (required) language in which the URL is in (english, french, etc..)

Note: if the lang parameter is missing, the default is english.

Output scenarios:

When everything goes well (for the request above)

HTTP code: 200 OK
{
  "article": {
    "text": "We've got your back since 2016\\n\\nOur skills and knowledge are very flexible - we are able to meet literally any IT challenge that the market can face today.\\n\\nPresent on the market since 2016, we have managed to gain the trust and respect of our customers. Long-term relationships and satisfied customers have always been one of our main goals.",
    "main_image": "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1611010847\\/website\\/otimbi-cover-social-1.jpg",
    "authors": [],
    "title": "Trusted technology provider",
    "images": [
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/gcf_ca.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/gcf_ml.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/navigation\\/up-down.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1607332083\\/website\\/hero.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/social\\/twitter.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/social\\/instagram.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/social\\/facebook.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/communication\\/mail.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1607378516\\/website\\/portfolio\\/logos\\/ea3dc26a-36d6-4989-8596-ac871e4a9e82-1565162002737.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/communication\\/group.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/code\\/code.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1609178636\\/website\\/testimonials\\/nabingi.jpg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/decorations\\/deco-blob-1.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/communication\\/call-1.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/AWS-Certified_Solutions-Architect_Associate.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/interface\\/star.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/decorations\\/deco-dots-6.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/devices\\/android.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1609178200\\/website\\/otimbi-logo-white.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/decorations\\/deco-blob-8.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/home\\/book-open.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/shopping\\/dollar.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1609178528\\/website\\/testimonials\\/prince-pascal.jpg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1609178450\\/website\\/testimonials\\/belllo-alkaly.jpg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/dividers\\/divider-1.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/dividers\\/divider-3.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/interface\\/cross.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/interface\\/menu.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/ic_blockchain.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1607377163\\/website\\/portfolio\\/QXpfJKSuFRFwyEPryCvwPXMk2ig-2YqJ-8UH7VvCXbr4qIUsXPicu24wVvikR5XOKw_w3200-h2394-rw.webp",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/[email protected]",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1611010847\\/website\\/otimbi-cover-social-1.jpg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/devices\\/laptop.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/dividers\\/divider-2.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/devices\\/phone.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1607378320\\/website\\/portfolio\\/logos\\/hda-2.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/map\\/marker-1.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/navigation\\/arrow-up.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/certifications\\/AWS-Certified_Cloud-Practitioner.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/home\\/flower-3.svg",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/home\\/door-open.svg",
      "https:\\/\\/res.cloudinary.com\\/otimbilabs\\/image\\/upload\\/v1607378191\\/website\\/portfolio\\/logos\\/umoja-2.png",
      "https:\\/\\/otimbi.com\\/theme\\/assets\\/img\\/icons\\/theme\\/home\\/building.svg"
    ],
    "links": [],
    "summary": "We've got your back since 2016Our skills and knowledge are very flexible - we are able to meet literally any IT challenge that the market can face today.\\nPresent on the market since 2016, we have managed to gain the trust and respect of our customers.\\nLong-term relationships and satisfied customers have always been one of our main goals.",
    "keywords": [
      "technology",
      "skills",
      "satisfied",
      "provider",
      "trust",
      "meet",
      "trusted",
      "customers",
      "weve",
      "todaypresent",
      "respect",
      "market",
      "relationships"
    ]
  },
  "errors": [],
  "success": true
}

Some error scenarios:

  1. when missing the extract_url parameter.
HTTP code: 400 Bad Request
{
  "errors": {
    "no_content": "Please enter a valid URL."
  },
  "success": false
}
  1. here the user did not provide their API credentials (they are found in the dashboard)
HTTP code: 401 Unauthorized
{
  "success": false,
  "errors": {
    "empty_api_key": "Provide an API key",
    "empty_username": "Provide a username"
  }
}

<aside> 💡 Thoughts, comments, concerns? Please reach out to us via Twitter @tiq_ai or via email [email protected]

</aside>