Magicpin Hyperlocal Data API · Live

Pull live Magicpin data
down to the cashback %
and the store address.

Merchant listings, cashback rates, active deals, ratings, and location detail across restaurants, salons, and retail stores — structured and delivered as clean JSON or CSV. No proxies to manage, no CAPTCHAs to solve, no HTML to parse.

See a Live Response
100K+ Merchants Tracked
8M+ Daily Cashback Checks
4 Verticals Covered
Real-Time Data Refresh
GET /v1/magicpin/merchant
LIVE
// request timestamp 2026-07-10 04:31:10 UTC { "merchant_id": "MGP3312987", "vertical": "Health & Beauty", "name": "Glow Salon & Spa, HSR Layout", "cashback_pct": 25, "min_spend": 300, "currency": "INR", "rating": 4.6, "review_count": 912, "status": "open", "verified_merchant": true, "fetched_in_ms": 1738 }
TRUSTED BY CLIENTS ACROSS MULTIPLE INDUSTRIES
Local Commerce Fintech Retail Analytics Market Research Logistics Technology
280+
GLOBAL CLIENTS SERVED
160+
PROJECTS DELIVERED
14M+
MONTHLY API CALLS
24/7
DEDICATED SUPPORT
Why Choose Our Magicpin API

A cashback rate that changes by the hour needs a feed that keeps up.

Between cashback percentages that shift by merchant and time of day, deals tied to minimum spend, and a catalog of local businesses instead of shippable products, hyperlocal commerce data behaves nothing like a standard e-commerce listing. Our infrastructure absorbs that complexity so your team just calls an endpoint and gets data back.

01

Zero blocking, zero maintenance

We run rotating residential IPs, headless rendering, and CAPTCHA-solving behind every request. When Magicpin changes its layout, we patch our parsers — your integration never breaks.

02

Cashback & deal-term aware

Every response separates the cashback percentage, minimum spend requirement, and active deal terms so you're never guessing at the fine print.

03

Location & category level detail

We resolve merchant address, geo-coordinates, locality, and business category so results can be filtered by area, not just keyword.

04

Built for scale from day one

From a 100-merchant test batch to millions of daily checks across cities, the same endpoint and response shape scale with you.

Magicpin API Features

Everything you need to keep Magicpin data flowing.

Real-time Extraction

Trigger an on-demand pull for any merchant ID or keyword and get a fresh response — not a stale cache.

🧩

Custom Field Selection

Request only the fields you need — cashback, hours, reviews — to cut payload size and parsing time.

📍

Geo & Locality Resolution

Search merchants by city, locality, or radius around a coordinate pair.

📦

Bulk & Scheduled Requests

Submit thousands of merchant IDs in one batch job or schedule recurring pulls on an hourly, daily, or custom cadence.

🏷️

Flash Cashback Detection

Flag time-limited cashback boosts and Magicpin Flash Cashback Days pricing automatically.

📊

Historical Cashback Tracking

Store and query cashback-rate history per merchant to power local-market trend analysis.

What Data Can You Access?

Every field a merchant page shows — cashback and location included.

CoreMerchant name & IDBusiness category, sub-category
CashbackCashback percentageMagicpin cash reward rate, cap
OffersActive deal termsMinimum spend, deal expiry, terms
LocationAddress & geo-coordinatesLocality, area, city
HoursOperating hoursOpen/closed status, weekly schedule
MediaImagesStorefront photos, menu images
ReviewsRatings & review countAverage rating, star breakdown
ReviewsIndividual reviewsText, rating, visit date
PaymentPayment eligibilityIn-app payment requirement for cashback
StructureCategory breadcrumbsFull category tree path
MenuMenu items & pricingFor restaurants: dish name, price
TrustVerified merchant badgeOnboarding & authenticity flag
Supported Magicpin Verticals

Food, fashion, beauty, and services — one integration covers all of it.

Switch the vertical parameter to pull from a different Magicpin category with the same consistent response shape.

🍽️

Food & Dining

Restaurants, cafes & QSR outlets catalog.

🛍️

Fashion & Lifestyle

Apparel, footwear & accessory retail stores.

💆

Health & Beauty

Salons, spas & wellness centers catalog.

📱

Electronics & Services

Electronics retail & local service providers.

India-wide

Merchant coverage across major metros & tier-2 cities

Geo Radius

Search merchants by locality or coordinate radius

Real-time

Cashback and deal terms checked on every request

Magicpin API Endpoints

A small set of endpoints that cover the whole merchant lifecycle.

Method Endpoint Description Typical use
GET /v1/magicpin/merchant Full merchant detail by merchant ID or URL Cashback & offer monitoring
GET /v1/magicpin/search Keyword, category, or locality search results Local market discovery
GET /v1/magicpin/reviews Paginated customer reviews for a merchant Sentiment analysis
GET /v1/magicpin/deals Active cashback boosts & flash offers Promo & pricing intelligence
GET /v1/magicpin/locations Merchants within a locality or coordinate radius Footfall & area analysis
POST /v1/magicpin/bulk Submit up to 10,000 merchant IDs per batch job City-wide monitoring
GET /v1/magicpin/category Category tree metadata Taxonomy mapping
Live API Response Example

This is exactly what comes back. No extra parsing needed.


        
Popular Magicpin API Use Cases

Built for the teams that live and die by Magicpin data.

📈

Cashback & Deal Monitoring

Feed live cashback rates and active deal terms into your tracking tools every few minutes.

🔍

Hyperlocal Market Research

Analyze merchant density, category mix, and cashback trends by locality.

🛡️

Merchant Distribution Tracking

Track where your brand's outlets are listed and what cashback rates they carry.

💬

Review & Sentiment Mining

Pull reviews across categories to power local-business comparison tools.

🤖

ML Training Data

Generate labeled merchant, cashback, and location datasets for recommendation models.

📍

Footfall & Location Analytics

Map merchant density and category clustering across cities and neighborhoods.

🏆

Competitive Benchmarking

Track how your locations compare on cashback and rating against nearby competitors.

🎟️

Offer & Coupon Tracking

Monitor how deal structures and minimum-spend terms shift across merchant categories.

How the Magicpin API Works

From API key to structured data in five steps.

1

Get your API key

Sign up and generate a key from your dashboard in under two minutes.

2

Choose an endpoint

Pick /merchant, /search, /reviews or /deals depending on what you need.

3

Send the request

Call the endpoint with a merchant ID, keyword, or locality and your vertical parameter.

4

We handle the hard part

Proxies, headless rendering, CAPTCHA-solving, and parsing all happen behind the scenes.

5

Receive structured data

Get clean JSON or CSV back in seconds, ready to drop into your pipeline.

Developer-Friendly Integration

Built by people who read the docs too.

One consistent JSON schema across every endpoint and every vertical. No SDK lock-in — plain REST calls work from any language or platform.

Predictable REST design

Standard HTTP verbs, query params, and status codes — nothing proprietary to learn.

JSON, CSV, or webhook delivery

Get results inline, as a downloadable file, or pushed to your endpoint when a batch job finishes.

Sandbox & test keys

Free sandbox environment with sample merchant IDs so you can build before you pay.

Postman collection & SDK snippets

Import a ready-made collection or copy request snippets for Python, Node.js, and cURL.

Quickstart
API Performance & Reliability

Numbers we publish because we track them daily.

99.9%
Uptime SLA
<3s
Avg. response time
99.0%
Successful extraction rate
6K+
Concurrent requests supported
Security & Compliance

Compliant by design, not as an afterthought.

🔒

Encrypted in transit

All requests and responses travel over TLS 1.2+. API keys can be scoped and rotated anytime.

⚖️

India DPDP & global alignment

Our extraction workflows are built around India's Digital Personal Data Protection Act alongside GDPR and CCPA guidelines.

🌐

Public-data-only policy

We collect only publicly accessible merchant listing data — never login-gated or private account information.

ISO 9001:2015 Certified ISO/IEC 27001:2013 Certified IAF Multilateral Recognition GDPR-aligned workflows
API Documentation & Resources

Everything to go from key to production.

Guide

Quickstart Guide

Get your first API response back in under five minutes.

Read guide →
Reference

Full API Reference

Every endpoint, parameter, and response field documented in detail.

View reference →
Tool

Postman Collection

Import ready-made requests for every Magicpin API endpoint.

Download →
Code

SDKs & Code Samples

Python, Node.js, PHP, and Ruby snippets for every use case.

Browse samples →
Frequently Asked Questions

Still deciding? Here's what most teams ask first.

We collect only publicly accessible merchant listing data using automated tools, following publicly available web-data guidelines. We recommend reviewing your own use case with legal counsel, especially for redistribution.

Every request to /merchant, /search, and /deals triggers a live pull — you're not reading from a stale cache. Bulk jobs complete within minutes depending on batch size.

Yes. The /locations endpoint accepts a locality name or coordinate pair with a radius, returning every eligible merchant in that area.

Yes — pass the appropriate vertical parameter to pull from Health & Beauty, Electronics & Services, Fashion & Lifestyle, or Food & Dining using the same response schema.

Our infrastructure retries automatically across a rotating proxy pool. You're only billed for successfully returned responses.

Yes, every account starts with a free sandbox key and sample credits so you can test all endpoints before committing to a plan.

Brand Image
INQUIRE NOW