API Documentation

Our API is currently in private beta and used to power our own free tools. We plan to release a public version in the future. Below is a brief overview of our internal endpoints.

All endpoints live at: https://api.willittrend.com

Endpoints

Generate Hashtags

POST/api/hashtags

Generates a list of hashtags based on a provided topic.

Request Body (JSON):
{
    "topic": "AI Art"
}
Success Response (200):
{
    "hashtags": [
        "aiart",
        "aiarts",
        "aiarttips",
        "aiartcommunity",
        "midjourney",
        "dalle3",
        "generativeart",
        "trending",
        "viral",
        "fyp",
        "contentcreation",
        "growthhacks"
    ]
}

Keyword Research

POST/api/keywords

Finds related keywords from our database based on a topic.

Request Body (JSON):
{
    "topic": "side hustle"
}
Success Response (200):
{
    "keywords": [
        { "keyword": "side hustle ideas 2026", "type": "long-tail" },
        { "keyword": "how to start a side hustle", "type": "question" },
        { "keyword": "passive income ideas", "type": "related" },
        { "keyword": "makemoneyonline", "type": "broad" },
        { "keyword": "small business ideas", "type": "related" }
    ]
}

Best Time to Post

POST/api/timing

Returns the best posting times for a specific platform.

Request Body (JSON):
{
    "platform": "instagram"
}
Success Response (200):
{
    "bestTimes": [
        { "day_of_week": "Tuesday", "time_slot": "11:00 AM - 2:00 PM" },
        { "day_of_week": "Wednesday", "time_slot": "10:00 AM - 1:00 PM" },
        { "day_of_week": "Thursday", "time_slot": "10:00 AM - 2:00 PM" }
    ]
}

Live Google Trends

GET/api/trends

Gets the top daily trending searches from Google Trends (US).

Success Response (200):
{
    "trends": [
        {
            "title": { "query": "Example Trend", "exploreLink": "/trends/..." },
            "formattedTraffic": "100K+ Searches"
        },
        {
            "title": { "query": "Another Trend", "exploreLink": "/trends/..." },
            "formattedTraffic": "50K+ Searches"
        }
    ]
}