Skip to main content
POST
/
api
/
research
curl --request POST \
  --url https://query-mapping.ypym.app/api/research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "keyword": "jasa seo jakarta",
    "market": "id",
    "sector": "IDXTECHNO",
    "intent": "commercial",
    "depth": "deep",
    "ymyl_flag": false
  }'

{
  "keyword": "jasa seo jakarta",
  "market": "id",
  "search_volume": 2400,
  "competition": 0.72,
  "intent": "commercial",
  "trend": [1800, 2100, 2200, 2400, 2600, 2400, 2300, 2400, 2500, 2400, 2200, 2400],
  "serp_features": [
    "local_pack",
    "people_also_ask",
    "site_links",
    "ai_overview"
  ],
  "sector": "IDXTECHNO",
  "related_keywords": [
    {
      "keyword": "jasa seo profesional",
      "volume": 880,
      "competition": 0.65
    },
    {
      "keyword": "agency seo indonesia",
      "volume": 1200,
      "competition": 0.78
    },
    {
      "keyword": "harga jasa seo",
      "volume": 720,
      "competition": 0.58
    }
  ],
  "content_clusters": [
    {
      "cluster": "SEO Agency Services",
      "keywords": 24,
      "total_volume": 8400
    }
  ]
}

​
Overview

YPYM Keywords is a restricted-access keyword research and competitive intelligence platform. It powers the data layer behind YPYM’s SEO service engagements, from market entry keyword mapping to Pre-IPO search authority audits. Unlike generic keyword tools, YPYM Keywords is calibrated for Indonesia and Southeast Asian markets, with deep IDX sector coverage and YMYL-specific query intelligence.
YPYM Keywords is a restricted-access product. For demo access, please email [email protected].Live instance: query-mapping.ypym.app

​
Core Capabilities

​
keyword
string
required
The seed keyword or phrase to research. Supports Bahasa Indonesia, English, and mixed-language queries.
​
market
string
default:"id"
Target market for search volume and competition data. Supported: id (Indonesia), sg, my, th, ph, vn, global.
​
sector
string
IDX sector filter for industry-specific keyword intelligence. Examples: IDXFINANCE, IDXHEALTH, IDXENERGY, IDXTECHNO.
​
intent
string
default:"all"
Filter by search intent classification. Options: informational, navigational, commercial, transactional, all.
​
depth
string
default:"standard"
Analysis depth. standard returns volume and competition. deep adds SERP feature analysis, competitor mapping, and content gap scoring.
​
ymyl_flag
boolean
default:"false"
Enable YMYL (Your Money Your Life) compliance scoring for finance, health, legal, and government-related keywords.

​
Feature Matrix

FeatureDescription
Search Volume IntelligenceLocalised monthly search volume with seasonal trend data for ID and SEA markets
Competition ScoringProprietary difficulty score calibrated against actual SERP composition, not generic estimates
SERP Feature MappingIdentifies featured snippets, PAA, knowledge panels, local packs, and AI overviews per keyword
Intent ClassificationAutomated search intent scoring: informational, navigational, commercial, transactional
IDX Sector MappingMaps keywords to Indonesia Stock Exchange sector classifications for business intelligence alignment
YMYL ScoringFlags keywords under Google’s elevated quality thresholds with E-E-A-T requirement signals
Competitor Gap AnalysisIdentifies keyword opportunities where competitors rank but the target domain does not
Content Cluster EngineGroups keywords into topical authority clusters for content strategy planning

​
Response Fields

​
keyword
string
The queried keyword.
​
search_volume
integer
Monthly search volume in the target market.
​
competition
float
Competition score from 0.0 (low) to 1.0 (extremely competitive).
​
intent
string
Classified search intent.
​
serp_features
array
SERP features present for this keyword (e.g., featured_snippet, people_also_ask, local_pack, ai_overview).
​
ymyl_score
float
YMYL compliance risk score from 0.0 to 1.0. Only present when ymyl_flag is enabled.

​
Access

Live Instance

Restricted access: password required

Request Demo

Email [email protected] for demo credentials
curl --request POST \
  --url https://query-mapping.ypym.app/api/research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "keyword": "jasa seo jakarta",
    "market": "id",
    "sector": "IDXTECHNO",
    "intent": "commercial",
    "depth": "deep",
    "ymyl_flag": false
  }'

{
  "keyword": "jasa seo jakarta",
  "market": "id",
  "search_volume": 2400,
  "competition": 0.72,
  "intent": "commercial",
  "trend": [1800, 2100, 2200, 2400, 2600, 2400, 2300, 2400, 2500, 2400, 2200, 2400],
  "serp_features": [
    "local_pack",
    "people_also_ask",
    "site_links",
    "ai_overview"
  ],
  "sector": "IDXTECHNO",
  "related_keywords": [
    {
      "keyword": "jasa seo profesional",
      "volume": 880,
      "competition": 0.65
    },
    {
      "keyword": "agency seo indonesia",
      "volume": 1200,
      "competition": 0.78
    },
    {
      "keyword": "harga jasa seo",
      "volume": 720,
      "competition": 0.58
    }
  ],
  "content_clusters": [
    {
      "cluster": "SEO Agency Services",
      "keywords": 24,
      "total_volume": 8400
    }
  ]
}