canonical: https://jentic.com/apis/ritekit.com/ritekit-main

# RiteKit API

The RiteKit API scores hashtags and prepares social posts: it returns real-time stats for up to 100 hashtags at once, the last 30 days of history for a single hashtag, and the hashtags currently trending on Twitter. It also rewrites post text by adding relevant hashtags or emoji, strips banned hashtags before an Instagram post, and suggests hashtags for a topic. Supporting tools shorten links with a call to action, fetch a company logo from its domain, and render a quote as a styled image.

## For AI agents

Check hashtag stats and 30-day history, find trending Twitter hashtags, and auto-hashtag or emojify post text before an agent publishes it.

## Scope

Does not publish or schedule posts, read social account inboxes, or track brand mentions. Use for hashtag research and preparing post text and images only.

## Capabilities

- Pull real-time stats for up to 100 hashtags in one call via the tags parameter
- Read a hashtag's historical stats for the last 30 days
- List hashtags currently trending on Twitter, optionally limited to green or latin-character tags
- Auto-hashtag a post with maxHashtags and an end or auto hashtagPosition
- Remove banned hashtags from an Instagram post before publishing
- Add emoji to post text or return emoji suggestions for it
- Render a quote and author as a styled image with font, color, and gradient options

## Use cases

### AI social copywriter with hashtag checks

An agent drafting social posts needs evidence for which hashtags to use instead of guessing. Through Jentic it searches for 'hashtag stats', loads RiteKit's GET `/v1/stats/multiple-hashtags`, and passes the candidate tags to get real-time stats for each, then calls GET `/v1/stats/auto-hashtag` to insert the chosen ones into the draft. The developer reviews the finished post before it goes out.

Example prompt: Call GET `/v1/stats/multiple-hashtags` with tags 'ai,machinelearning,python', then call GET `/v1/stats/auto-hashtag` with the draft as post, maxHashtags 2, and hashtagPosition 'end'

### Trend monitoring for a content calendar

A social media manager checks what is rising before planning the week. GET `/v1/search/trending` returns hashtags currently trending on Twitter, with green to restrict results to hashtags that are not overused and latin to keep only latin-character tags. GET `/v1/stats/history/{hashtag}` then shows the last 30 days for any tag worth tracking.

Example prompt: Call GET `/v1/search/trending` with green 1 and latin 1, then call GET `/v1/stats/history/{hashtag}` for the top three results

### Instagram caption cleanup

Posting with a banned hashtag can limit an Instagram post's reach. GET `/v2/instagram/hashtags-cleaner` takes the post text and returns it with banned hashtags removed, so a scheduling tool can clean every caption just before it is queued.

Example prompt: Call GET `/v2/instagram/hashtags-cleaner` with the caption as post and use the returned text as the final caption

### Visual assets for posts

Text posts perform better with an image. GET `/v1/images/quote` renders a quote and author into an image using parameters such as quoteFont, fontSize, bgType, gradientColor1, and brandLogo, and GET `/v1/images/logo` returns a company logo for a domain, extracting it from the site on the fly when it is not yet stored.

Example prompt: Call GET `/v1/images/quote` with quote 'Ship small, ship often', author 'Team Lead', and bgType 'gradient', then attach the returned image URL to the post

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/stats/multiple-hashtags` | Real-time stats for up to 100 hashtags |
| GET | `/v1/stats/history/{hashtag}` | 30-day history for a hashtag |
| GET | `/v1/search/trending` | Hashtags trending on Twitter |
| GET | `/v1/stats/auto-hashtag` | Add hashtags to post text |
| GET | `/v1/stats/hashtag-suggestions` | Hashtag suggestions for a topic |
| GET | `/v2/instagram/hashtags-cleaner` | Remove banned Instagram hashtags |
| GET | `/v1/emoji/auto-emojify` | Add emoji to post text |
| GET | `/v1/images/quote` | Render a quote as an image |

## Key resources

- **Hashtag stats** — Real-time and 30-day historical metrics for hashtags
- **Trending hashtags** — Hashtags currently trending on Twitter, filterable to green and latin tags
- **Post text tools** — Auto-hashtag, auto-emojify, emoji suggestions, and Instagram banned-hashtag cleaning
- **Images** — Quote images, animated GIFs, and company logos by domain
- **Links** — Short links with an attached call to action

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 45 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 48 / 100
  - Developer Experience & Jentic Compatibility: 65 / 100
  - AI-Readiness & Agent Experience: 20 / 100
  - Agent Usability: 94 / 100
  - Security: 100 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/ritekit.com/ritekit-main/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring RiteKit by hand means reading its spec description to learn that a Client ID can ride as a query parameter even though the spec declares no scheme, then mapping 13 GET tools spread across stats, emoji, image, and link paths. Through Jentic you install once, import RiteKit from the API Directory, and your agent calls it.
- **Permission scoping:** RiteKit takes nearly all of its input as query parameters, with only the hashtag history route carrying a value in the path, so limit the agent to the operations it needs, such as hashtag stats and trending search. You choose the operations it may call, so ones like GET `/v1/link/short-link` or image generation are not included unless you add them.
- **Credential handling:** The RiteKit spec declares no credential, so the agent holds no secret for these calls. If you add a RiteKit Client ID to your own Jentic One instance, it is kept encrypted and injected at execution time, outside the agent's prompt, logs, and context.
- **Discovery method:** Agents search Jentic by intent such as 'hashtag stats' or 'clean Instagram hashtags', and Jentic returns the matching RiteKit operation with its input schema, including parameters like maxHashtags and hashtagPosition.

## Related APIs

- **Mention** — Brand and keyword mention monitoring across web and social sources
- **Bitly** — Dedicated link shortening with click analytics
- **Instagram** — Publish and manage Instagram content after captions are cleaned

## FAQ

### What authentication does the RiteKit API use?

This OpenAPI spec declares no security scheme and no credential parameter on its 13 operations. The spec's own description says RiteKit issues a Client ID and Client secret from its developer dashboard, accepts the Client ID as a client_id query parameter, and also supports OAuth 2.0, and it notes that GET `/v1/link/cta` requires each user to authenticate with RiteKit. Check the RiteKit developer dashboard for the current authorization options.

### Can I check several hashtags in one request with the RiteKit API?

Yes. GET `/v1/stats/multiple-hashtags` takes a tags parameter with hashtags written without the # mark and returns real-time stats for up to 100 of them, updated hourly. For a single tag's trend over time, GET `/v1/stats/history/{hashtag}` returns the last 30 days.

### What are the rate limits for the RiteKit API?

The OpenAPI spec does not specify rate limits. Its description mentions a free monthly call allowance with paid tiers above it; see https://ritekit.com/developer/ for the current limits.

### Is there a RiteKit MCP server?

You do not need an MCP server to give your agent RiteKit. Jentic connects it directly from the API Directory: import it and your agent finds hashtag, emoji, and image operations by intent, without a separate server's tool list sitting in its context.

### How do I auto-hashtag a post through Jentic?

Search Jentic for 'add hashtags to a post', load the GET `/v1/stats/auto-hashtag` operation, and pass the text as post, plus maxHashtags and hashtagPosition set to end or auto. The response is the post with hashtags inserted. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the RiteKit API?

Yes. For a research assistant, write a rule that allows only GET `/v1/stats/multiple-hashtags`, GET `/v1/stats/history/{hashtag}`, and GET `/v1/search/trending.` The agent can then read hashtag data but cannot shorten links or generate images, and every call it makes is logged.
