▣ ARTIFICIAL INTELLIGENCE · MARKETING

Intelligent Competitor Mapping API

What it does

Competitor Analysis identifies likely competitors for a website URL and returns a market view you can use in research, positioning, or sales prep. Send a website URL and get back the analyzed URL, subscription tier, timestamp, and a structured marketAnalysis object.

The response includes the business's industry, a list of competitors, the market niche, and a differentiationStrategy. Each competitor entry includes a name, a reason it was matched, and a likelyOverlap score from 0 to 100. That makes it easier to compare direct rivals, understand why they were selected, and estimate how closely they compete for the same audience.

Use Competitor Analysis when you need to build a competitive landscape from a single domain, enrich a company profile, or automate account research before outreach. For example, a marketing team can pass in a prospect's homepage to identify the main alternatives and adjust messaging based on the niche and overlap it returns.

POST

Identify competitors for a given URL

https://api.eu.apyhub.com/namastesumalya/identify-competitors

QUICKSTART

GUIDE

Quickstart

Identify competitors for a website by sending its URL.

curl -X POST "https://api.eu.apyhub.com/namastesumalya/identify-competitors" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://apyhub.com"}'

What you'll get back

Returns a JSON object with fields such as url (string), tier (string), timestamp (string), and marketAnalysis (object).

marketAnalysis contains industry (string), competitors (array of objects with name, reason, and likelyOverlap), marketNiche (string), and differentiationStrategy (string).

{
  "url": "https://slack.com",
  "tier": "premium",
  "timestamp": "2026-03-29T19:12:02.292Z",
  "marketAnalysis": {
    "industry": "AI Work Platform & Productivity Tools",
    "competitors": [
      {
        "name": "Microsoft Teams",
        "reason": "Direct competitor offering integrated chat, video, and collaboration within the Microsoft 365 ecosystem.",
        "likelyOverlap": 95
      }
    ],
    "marketNiche": "Enterprise Team Communication, Collaboration, and AI-powered Workflow Automation",
    "differentiationStrategy": "Slack can differentiate by deepening its AI-powered workflow automation and third-party app ecosystem."
  }
}

TRY ITLIVE · 2000 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Identifies competitors for a given website URL and returns an analysis object describing the analyzed URL, subscription tier, timestamp, and market analysis details.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	The website URL for which competitors will be identified. Must be a URI.

Response

Returns a JSON object with url and tier string fields, a timestamp string field in date-time format, and a marketAnalysis object field containing industry, competitors, market niche, and differentiation strategy details.

Parameter	Type	Mandatory	Description
url	String	No	The analyzed URL. Must be a URI.
tier	String	No	Subscription tier associated with the response detail level.
timestamp	String	No	Timestamp when the analysis was generated. Date-time format.
marketAnalysis	Object	No	Market analysis details. Includes `industry`, `competitors`, `marketNiche`, and `differentiationStrategy`.
marketAnalysis.industry	String	No	The broad industry classification of the analyzed business.
marketAnalysis.competitors	Object Array	No	List of identified competitors. Each item includes `name`, `reason`, and `likelyOverlap`.
marketAnalysis.competitors[].name	String	No	Name of the identified competitor.
marketAnalysis.competitors[].reason	String	No	Explanation of why this entity is considered a competitor.
marketAnalysis.competitors[].likelyOverlap	Integer	No	Estimated percentage overlap in target market/audience. Minimum 0, maximum 100.
marketAnalysis.marketNiche	String	No	The specific market niche the business operates in.
marketAnalysis.differentiationStrategy	String	No	Suggested strategy for differentiating from competitors.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.