API Documentation

MarketGeist API

Integrate continuous market intelligence into your applications, dashboards, and workflows. The MarketGeist API provides programmatic access to AI-powered reports, competitor analysis, trend monitoring, and market data.

Base URL

https://marketgeist.com/api/v1/public

Quick Start

1

Create an API key

Go to Dashboard → API Keys and create a new key with the scopes you need.

2

Make your first request

Include your API key in the X-API-Key header.

3

Process the response

All responses return JSON with a success boolean and a data field.

cURL

curl -X GET "https://marketgeist.com/api/v1/public/reports" \
  -H "X-API-Key: mg_live_your_key_here"

Available APIs

Market Reports

Generate AI-powered market research reports on any niche or industry.

scope: reports

Competitor Tracking

Monitor competitor websites, pricing, and positioning changes.

scope: competitors

SEO Intelligence

Track keywords, rankings, and trending search topics.

scope: seo

Market Signals

Real-time news and intelligence from across the web.

scope: signals

Social Trends

Trending topics from Reddit, X, TikTok, and Google Trends.

scope: social_trends

Market Data

Company profiles, sector data, and industry analytics.

scope: market_data

Next Steps

Authentication →

Learn how to authenticate API requests with API keys and JWT tokens.

Endpoint Reference →

Full reference for all available API endpoints with request and response schemas.

Code Examples →

Ready-to-use code in Python, JavaScript, Go, Ruby, PHP, and cURL.

Rate Limits →

Understand rate limit tiers, headers, and best practices for handling limits.