Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.hoopai.com/llms.txt

Use this file to discover all available pages before exploring further.

The HoopAI Platform Blogs REST API gives you programmatic control over every layer of your blog infrastructure. Use it to create and publish posts, manage authors and categories, configure RSS feeds, import posts from external URLs or CSV files, and retrieve performance statistics — all without leaving your own application.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

Every request requires a Bearer token and an API version header. 
Authorization: Bearer <access_token>
Version: 2021-07-28
Use an access token generated with user type Account, or a Private Integration Token from an Account. See OAuth 2.0 for details.

​
OAuth scopes

ScopeAccess granted
blogs.readonlyRead blog sites, posts, authors, and categories
blogs.writeCreate, update, and delete blog sites, posts, authors, and categories

​
Quick start

Retrieve all blogs for a location: 
curl -X GET "https://services.leadconnectorhq.com/blogs/site/all?locationId=<locationId>&skip=0&limit=10&searchTerm=" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28"

​
Endpoints

MethodPathDescription
GET/blogs/site/allGet blogs by location ID
POST/blogs/siteCreate a blog site
POST/blogs/site/rssCreate an RSS feed
GET/blogs/site/rssGet RSS feeds
PUT/blogs/site/rss/{id}Update an RSS feed
DELETE/blogs/site/rss/{id}Delete an RSS feed
GET/blogs/site/rss-migrationGet RSS migration status
POST/blogs/site/rss-migrationUpdate RSS migration status
POST/blogs/site/load-snapshotLoad a blog snapshot
POST/blogs/site/create-importCreate a blog import
POST/blogs/site/import-csvImport blog posts from CSV/XLSX file
GET/blogs/site/importsFetch blog imports
GET/blogs/site/imports/allFetch all imports by ID
GET/blogs/site/import/{importId}Fetch a blog import by ID
PUT/blogs/site/import/{importId}Update a blog import
DELETE/blogs/site/import/{importId}Delete a blog import
PUT/blogs/site/create/import/{importId}Import blog posts from an import job
PUT/blogs/site/refresh/import/{importId}Refresh a blog import
PUT/blogs/site/import/link/{importId}Delete an import link
PUT/blogs/site/import/csv/{linkId}Update blog data for an import link
GET/blogs/site/check-sitemapCheck if sitemap exists
POST/blogs/postsCreate a blog post
PUT/blogs/posts/{postId}Update a blog post
GET/blogs/posts/allGet blog posts by blog ID
DELETE/blogs/posts/duplicateRemove duplicate blog posts
GET/blogs/posts/url-slug-existsCheck URL slug availability
GET/blogs/posts/snapshot/allGet blog post snapshots
POST/blogs/posts/check-snapshot-conflictCheck snapshot conflicts
GET/blogs/posts/unique/authorGet author list by blog ID
GET/blogs/posts/unique/categoryGet category list by blog ID
POST/blogs/posts/top-category-by-view-countGet top categories by view count
GET/blogs/posts/stats/imported-blog-post-ratioGet imported blog post ratio stats
GET/blogs/posts/stats/{locationId}Get blog post stats for a location
POST/blogs/posts/verify/blog-pathVerify a blog path
GET/blogs/authorsGet all blog authors
POST/blogs/authors/update-canonicalUpdate canonical links for authors
GET/blogs/categoriesGet all blog categories
DELETE/blogs/categories/{categoryId}Delete a blog category
POST/blogs/site/contact/tagsAdd tags to a contact
Last modified on March 5, 2026