Skip to content
POST /v1/keywords/

Discover trends from social conversations.

Keywords finds trends gaining attention or prominent now within a topic. Each result carries related phrases, measurements, context, and supporting posts.

01 / DISCOVER

Start with a query

Choose a topic, a query for the brand or category, and the market you target. This example follows a skincare brand in the US.

REQUEST
POSThttps://gist-api.the-alt.co/v1/keywords/skincare
Authorization: Bearer $GIST_KEY
query
skincare routines and product concerns
geo
US
mode
emerging
format
json
Show cURL request
curl -X POST https://gist-api.the-alt.co/v1/keywords/skincare \
  -H "Authorization: Bearer $GIST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"skincare routines and product concerns","geo":"US","mode":"emerging","format":"json"}'
THE RESPONSE

Trends and Keywords

One trend from the captured response, rendered with the fields your pipeline can use.

01

Blemish-Prone Calming Actives

medium

Treating active acne, closed comedones, and redness using targeted gentle ingredients such as azelaic acid and heartleaf extracts rather than overly harsh scrubs.

PhraseShare of VoiceGrowth
azelaicacid+50.3
heartleaf+81.8
active acne+71.4
FROM@brute.choi ↗
label
The trend name: a useful starting point for a content topic.
context
What people are discussing and how it relates to the query.
keywords
Related phrases to examine and translate into natural search queries.
keywordStats
Phrase-level Share of Voice and Growth for prioritization.
shareOfVoice
How much of the relevant social conversation is associated with a phrase in the latest week. Higher means more prominent around your query.
growth
Whether a phrase is gaining or losing traction versus recent weeks. A relative score, not a literal percentage change.
posts
Supporting sources your team can review alongside the idea.

Choose which trends rank first:

DEFAULT

emerging

Surfaces trends gaining attention, using Growth.

ALTERNATE

prevalent

Surfaces trends prominent now, using Share of Voice.

02 / INTEGRATE

Add gist to your content pipeline.

Insert Keywords before idea ranking and brief generation. Keep your search data, product priorities, and publishing process; gist adds current social trends and context to the candidates your tool already considers.

  1. 01

    Discover for each category

    Run Keywords with the brand’s topic, query, and market in emerging mode. Save the trend label, context, related phrases, measurements, posts, and knowledgeCutoff.

  2. 02

    Generate a grounded brief

    Feed the trend and related keywords into your idea generator alongside the brand’s products, editorial rules, and search data. Use the context and supporting posts to give each idea a concrete angle.

  3. 03

    Enhanced content brief

    For a focused follow-up, the Answers endpoint returns an explanation with supporting posts. Add that read to the brief when the idea needs more editorial context.

CONTENT IDEA

“A gentle routine for blemish-prone skin: where does heartleaf fit?”

A content idea for the brand to develop with its own expertise, products, and search data.
03 / LEVERAGE WITH SEARCH DATA

Combine gist with your search data.

Read gist signals alongside the search data your pipeline already uses to decide where a candidate goes.

gist signalSearch demandContent action
RisingEstablishedPrioritize. Create a relevant page or refresh an existing one.
RisingLimitedEarly bet. Explore a timely angle and add it to the content queue.
Flat / decliningEstablishedMaintain. Improve useful evergreen content.
Flat / decliningLimitedLower priority. Hold for now.

gist Keywords

Which trends are appearing in social conversations, and what related phrases, context, and posts explain them?

Google Trends

How is relative search interest changing for a term or topic?

Keyword Planner

What search keyword ideas and historical volumes can inform planning?

About the search data: Google Trends data · Google Keyword Planner

CONTINUE BUILDING

Find your next relevant topic.

Get an API key and add current trends, related phrases, and context to the content pipeline you already use.