MarketAtlas
Sign in Start free →
MarketAtlas Docs

Documentation

Everything you need to understand and use MarketAtlas — from search to the API.

Getting started

MarketAtlas is a Greek market intelligence platform built on top of the GEMI business registry (~1.9 million companies). It lets you search, filter, and monitor Greek companies in real time.

Search
Find companies by name, GEMI ID, or VAT number.
Monitor
Set alerts on registry changes and get notified instantly.
Integrate
Pull data into your own systems via the REST API.

Search & filters

The company search runs against the full GEMI registry using Elasticsearch full-text search. You can combine a free-text query with structured filters:

  • →Name / GEMI ID / VAT — full-text match across all registry name fields.
  • →Status — filter to active (Ενεργή), suspended, or dissolved companies.
  • →Legal form — AE, EPE, IKE, OE, EE, and more.
  • →NACE sector — industry classification using the EU NACE Rev. 2 taxonomy.
  • →Region / Municipality — narrow by Greek administrative region or municipality.
Tip: Results are sorted by relevance by default. Switch to "Newest" to surface recently registered companies.

Watchlists

Watchlists are named collections of companies you want to track together — a competitor set, a portfolio, or a prospect list.

  • →Create a watchlist from the Watchlists page or directly from any company card.
  • →Add or remove companies using the bookmark icon on company rows and detail pages.
  • →Watchlists are scoped to your organization — all members can see them.

Saved searches

Save any filtered search query to revisit it later without re-entering the criteria. Saved searches remember your full filter state — text query, status, legal form, sector, and region.

  • →Click Save search from the Companies page after applying filters.
  • →Access all saved searches from Companies → Saved searches.
  • →Saved searches are per-organization and visible to all members.

Alerts

Alerts notify you when something changes in the registry for companies you care about. They evaluate continuously as new GEMI data is ingested.

  • →Status change — company becomes active, suspended, or dissolved.
  • →Address change — registered address or region is updated.
  • →Custom metric threshold — a metric you defined crosses a value you set.
Note: Custom metric alerts require companies to be saved to the database (via a watchlist). Registry-only companies support status and address alerts only.

API reference

MarketAtlas exposes a REST API at /api/v1/. All endpoints return JSON and require an API key.

GET /api/v1/companies/ Search the registry
GET /api/v1/companies/{id}/ Company detail
GET /api/v1/alerts/ List your alerts
more Full API reference coming soon.

Authentication

API requests are authenticated with a per-organization API key passed in the X-API-Key header.

curl https://marketatlas.gr/api/v1/companies/ \
  -H "X-API-Key: your_api_key_here"

Generate and manage API keys from Organization → API Keys inside the app. Keys are shown once on creation and stored as a SHA-256 hash — keep them safe.

Rate limits

API rate limits are enforced per organization and vary by plan:

Plan Requests / minute Requests / day
Free 30 500
Team 120 5,000
Business 600 50,000

Exceeding limits returns a 429 Too Many Requests response. The Retry-After header indicates when to retry.