Topic API

The Market Pulse API is covered in detail here: https://docs.5x5coop.com/docs/market-pulse-api

There are two parameters required to create a custom topic:

• Topic Name: any character string, multiple words allowed
• Description: up to 150 words, providing more detail on that topic

Defining a Topic

Topic

Ideally, topics are neither too general (e.g. - "Sales"), nor too specific (e.g. - "Hewlett Packard Model 5890 Gas Chromatagraph Mass Spectrometer"). If the topic is a brand (e.g. - "Hewlett Packard"), the description should summarize the products and services the company provides, what industry the company is in, and competitive brands.

Topic Description

The ideal topic description would contain enough information for the AI engine to score content pages for their strength on this topic. Descriptions that don't contain enough information - they're too short - could result in fewer hits, and ultimately, a smaller audience. Conversely, descriptions with too much unrelated information could result in more false positives. Descriptions should be no more than 150 words.

Tips: Creating Custom Topic Descriptions

General Topic Title:
Fashion for women

Describe the main focus of the topic:
Example: "This topic focuses on the latest trends in female fashion, highlighting trendy materials and innovative designs."

Target Audience:
Example: "This topic targets fashion conscious female consumers, primarily aged 18-35, who are interested in trend concious living and fashion."

Content Scope:
Example: "Include a mix of content that provides in-depth analysis, how-to guides, and expert interviews related to current fashion."

Keywords and Phrases:
List the primary keywords and phrases that should be associated with this topic to ensure accurate targeting.
Example: "Current fashion, trendy clothing, fashion production, modern fashion, trendy women’s clothing brands."

Topic: Fashion for Women
This topic focuses on the latest trends in female fashion, highlighting trendy materials and innovative designs. This topic targets fashion-conscious female consumers, primarily aged 18-35, who are interested in trend-conscious living and fashion. Include a mix of content that provides in-depth analysis, how-to guides, and expert interviews related to current fashion trends, styling tips, and emerging designers. Keywords and Phrases: "Women's fashion, latest fashion trends, trendy materials, innovative designs, female fashion, fashion tips, style guides, women's clothing, fashion accessories, emerging designers."

You can use this description in your API request like this:
curl -X POST "https://aigds.4-eyes.ai/api/v1/topics/"
-H "Authorization: Bearer API_KEY"
-H "Content-Type: application/json"
-d '{"topic": "Fashion for Women", "description": "This topic focuses on the latest trends in female fashion, highlighting trendy materials and innovative designs. This topic targets fashion-conscious female consumers, primarily aged 18-35, who are interested in trend-conscious living and fashion. Include a mix of content that provides in-depth analysis, how-to guides, and expert interviews related to current fashion trends, styling tips, and emerging designers. Keywords and Phrases: "Women's fashion, latest fashion trends, trendy materials, innovative designs, female fashion, fashion tips, style guides, women's clothing, fashion accessories, emerging designers."Include a mix of content that provides in-depth analysis, how-to guides, and expert interviews related to current fashion trends, styling tips, and emerging designers. Keywords: women's fashion, latest fashion trends, trendy materials, innovative designs, female fashion, fashion tips, style guides, womem's clothing, fashion accessories, emerging designers."}'

Example Topic Definitions

{
"topic": "ERC",
"description": "The topic of ERC, or Employee Retention Credit, concerns a broad
range of issues related to a U.S. government initiative designed to support businesses
that retained employees during Covid-19 disruptions. The topic encompasses various ERC
aspects such as application processes, eligibility criteria, tax impacts, and specific
terms like ERC loans, refunds, and grants. Additionally, it covers various
service-related questions like the status of ERC refunds, contact numbers for Amazon
ERC, and information related to specific goods like Callaway ERC soft golf balls. The
ERC topic also includes concerns about potential scams, deadlines for tax credits, and
ongoing updates from the IRS regarding the ERC. This diverse array encompassing
financial support details, legal guidelines, and practical user inquiries is pivotal
for businesses seeking federal assistance during the crisis and post-crisis periods."
}
{
"topic": "Neuropathy",
"description": "Neuropathy refers to nerve damage or dysfunction, with symptoms
that include pain, numbness, and muscle weakness. This medical condition primarily
manifests in various forms such as peripheral, diabetic, and autonomic neuropathy,
affecting different parts of the body, notably the feet and legs. The discussion of
neuropathy covers its causes, ranging from diabetes to alcohol use, and explores
numerous treatments including medications, lifestyle changes, and alternative remedies
like foot massagers and specialized socks. Peripheral neuropathy is notably common and
multifaceted, initiating significant interest in its symptoms, diagnosis through tools
like the ICD-10 coding system, and targeted treatment options. Efforts to manage
neuropathy involve understanding the underlying conditions leading to nerve damage and
employing both conventional and innovative therapies to alleviate symptoms and improve
life quality."

Viewing the Results

• Results for your custom topics will begin to appear in your 5x5 S3 bucket, in the 'market_pulse/custom_topics/' folder, within 2-5 days. The file will update daily.
• Custom topics are only available to the account that created them, they are not available to the general Maket Pulse feed. It is possible that a product/brand/technology becomes important enough to be added to the general intent feed, but it would be created separately from the custom topic
• The schema for custom topics is the same as the general Market Pulse daily file, located here: https://docs.5x5coop.com/docs/market-pulse
• At this time, if you wish to change the description of the topic, you will need to create a new topic. To delete topics that are no longer needed, please contact your 5x5 account manager.
• The intent file can be used for digital, email, mail, or calling activation through the use of different linkage and data files, provided by 5x5. Your 5x5 account manager can help you get the files you need for any activation.