GET Text Search API · Mappls Developers

Legacy contract evidence

This operation was normalized from a MapmyIndia-generation specification. Validate its current Mappls host, path, package entitlement, authentication generation, and commercial availability before production use.

Request target

Call the operation

GEThttps://atlas.mapmyindia.com/api/places/textsearch/json?query=Where+is+Lajpat+Nagar

Base URLhttps://atlas.mapmyindia.com

Authenticationoauth2 bearer

Journey rolerequest response

Content typesNo request body

Path, query, and headers

Parameters

NameLocationTypeDescriptionExample

queryrequired

querystring

e.g. FODCOF, Shoes, Coffee, Versace, Gucci, H&M, Adidas, Starbucks, B130 {POI, House Number, keyword, tag}

Where is Lajpat Nagar

region

querystring

It takes in the country code. LKA, IND, BTN, BGD, NPL for Sri-Lanka, India, Bhutan, Bangladesh, Nepal respectively. Default is India (IND)

IND

location

querystring

Provides the location around which the search will be performed. e.g. location=28.454,77.435 It is STRONGLY RECOMMENDED to use this parameter for accurate location biased results.

28.612964,77.229463

filter

querystring

Filter parameter helps you restrict the result by mentioning pincode. e.g. filter=pin:110020

pin:110020

Interactive, local, and credential-safe

Build your request in eight languages

Change source-backed examples once, validate required inputs, and copy the synchronized cURL, JavaScript, Python, Java, C#, Go, PHP, or Ruby request. Credentials remain environment references, and this page never sends a provider request.

Local request composerCode stays local · fixtures are explicit

Generated in eight languages

Environment-backed credentials

GET

https://atlas.mapmyindia.com/api/places/textsearch/json?query=Where+is+Lajpat+Nagar&region=IND&location=28.612964%2C77.229463&filter=pin%3A110020

Credential-free sandboxExecute this contract without a provider call

How fixtures work

Generated from your inputs

curl --request GET \
  --url 'https://atlas.mapmyindia.com/api/places/textsearch/json?query=Where+is+Lajpat+Nagar&region=IND&location=28.612964%2C77.229463&filter=pin%3A110020' \
  --header "Accept: application/json" \
  --header "Authorization: Bearer ${MAPPLS_ACCESS_TOKEN}"

Credential-safe by constructionSet MAPPLS_ACCESS_TOKEN only in your trusted runtime. Code generation stays local. Sandbox execution sends only bounded fixture inputs to this developer platform and never reads a credential or calls Mappls.

Five language quickstarts

Send a production-shaped request

Examples use environment-backed access tokens, explicit timeouts where supported, status checks, and JSON bodies derived from the source schema. Replace sample identifiers and coordinates with values from your application.

GET /api/places/textsearch/json

curl --request GET \
  --url 'https://atlas.mapmyindia.com/api/places/textsearch/json?query=Where+is+Lajpat+Nagar' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Success and failure behavior

Responses

200

204

Not found

400

Bad request

401

API access denied

403

Forbidden

500

Something went wrong

503

Internal server error

200 response fields

FieldTypeDescriptionExample

suggestedLocation

array<object>

No field description in the source contract.

28.612964,77.229463

suggestedLocation[].typerequired

string

This is the type whether the results is POI or any building point.

POI

suggestedLocation[].typeXrequired

integer

Type attribute for internal use only for MapmyIndia.

7

suggestedLocation[].placeAddressrequired

string

Address of the location.

Yippee Rooms, Sector 56, Gurugram, Haryana, 122011

suggestedLocation[].latituderequired

number

It shows us the latitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

28.612964

suggestedLocation[].longituderequired

number

It shows us the longitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

77.229463

suggestedLocation[].eLocrequired

string

It is the Six or eight digit unique code offered only by mapmyindia to search for any address through this eLoc.

MMI000

suggestedLocation[].entryLatituderequired

number

It shows us the entry latitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

28.612964

suggestedLocation[].entryLongituderequired

number

It shows us the entry longitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

77.229463

suggestedLocation[].placeNamerequired

string

This shows the name of the POI

OYO Hotel

suggestedLocation[].alternateNamerequired

string

This shows the alternate name of the POI

OyoRooms,OYO 40400 Yippe Rooms,OYO Rooms Hotel

suggestedLocation[].keywordsrequired

array<object>

The keywords/category codes associated with the given result.

example

suggestedLocation[].addressTokensrequired

object

No field description in the source contract.

YOUR_ACCESS_TOKEN

suggestedLocation[].addressTokens.houseNumber

string

House Number of the POI.

237

suggestedLocation[].addressTokens.houseName

string

House Name of the POI.

MMI Building

suggestedLocation[].addressTokens.poi

string

Name of the POI.

MapmyIndia Head Office

suggestedLocation[].addressTokens.street

string

Name of the street.

—

suggestedLocation[].addressTokens.subSubLocality

string

Name of the subsublocality.

—

suggestedLocation[].addressTokens.subLocality

string

Name of the sublocality.

—

suggestedLocation[].addressTokens.locality

string

Name of the locality.

Okhla industrial phase 3

suggestedLocation[].addressTokens.village

string

Name of the village.

Okhla Vilage

suggestedLocation[].addressTokens.subDistrict

string

Name of the subDistrict.

—

suggestedLocation[].addressTokens.districtrequired

string

Name of the District.

South Delhi

suggestedLocation[].addressTokens.cityrequired

string

Name of the city.

New Delhi

suggestedLocation[].addressTokens.staterequired

string

Name of the STATE.

1700000000000

suggestedLocation[].addressTokens.pincode

integer

PINcode of the location.

110010

suggestedLocation[].prequired

integer

This shows the priority of the POI

11663

suggestedLocation[].orderIndexrequired

integer

This shows the order of the search results priority wise.

1

suggestedLocation[].scorerequired

number

This shows the score of the POI.

1.5075794782130676

suggestedLocation[].suggesterrequired

string

This shows on which basis the search results has been found.

alternateName

suggestedLocation[].richInforequired

array<object>

This shows the rich info associated with the given result.

—

userAddedLocation

array<object>

No field description in the source contract.

28.612964,77.229463

userAddedLocation[].eLocrequired

string

It is the Six or eight digit unique code offered only by mapmyindia to search for any address through this eLoc.

MMI000

userAddedLocation[].entryLatituderequired

number

latitude of the entrance of the location. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

28.612964

userAddedLocation[].entryLongituderequired

number

longitude of the entrance of the location. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

77.229463

userAddedLocation[].latituderequired

number

It shows us the latitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

28.612964

userAddedLocation[].longituderequired

number

It shows us the longitude of the location searched. Geometry information is NOT available in most use-case driven response; and is RESTRICTED.

77.229463

userAddedLocation[].orderIndexrequired

integer

This shows the order of the search results priority wise.

1

userAddedLocation[].placeAddressrequired

string

This is the address of the text searched by you.

Yippee Rooms, Sector 56, Gurugram, Haryana, 122011

userAddedLocation[].placeNamerequired

string

This shows the name of the POI.

OYO Hotel

userAddedLocation[].resultTyperequired

string

It Shows the the category of result falling into. For eg. UAP

UAP

userAddedLocation[].typerequired

string

No field description in the source contract.

—

userAddedLocation[].userNamerequired

string

It shows the UserID of the person who added the location.

usr1577100139i799918080

Response example

{
  "suggestedLocation": [
    {
      "type": "POI",
      "typeX": 7,
      "placeAddress": "Yippee Rooms, Sector 56, Gurugram, Haryana, 122011",
      "latitude": "RESTRICTED",
      "longitude": "RESTRICTED",
      "eLoc": "2LH9OC",
      "entryLatitude": "RESTRICTED",
      "entryLongitude": "RESTRICTED",
      "placeName": "OYO Hotel",
      "alternateName": "OyoRooms,OYO 40400 Yippe Rooms,OYO Rooms Hotel",
      "keywords": [
        "FINATM"
      ],
      "addressTokens": {
        "district": "South Delhi",
        "city": "New Delhi",
        "state": "Delhi"
      },
      "p": 11663,
      "orderIndex": 1,
      "score": 1.5075794782130676,
      "suggester": "alternateName",
      "richInfo": ""
    }
  ],
  "userAddedLocation": [
    {
      "eLoc": "2LH9OC",
      "entryLatitude": "RESTRICTED",
      "entryLongitude": "RESTRICTED",
      "latitude": "RESTRICTED",
      "longitude": "RESTRICTED",
      "orderIndex": 1,
      "placeAddress": "Yippee Rooms, Sector 56, Gurugram, Haryana, 122011",
      "placeName": "OYO Hotel",
      "resultType": "UAP",
      "type": "",
      "userName": "usr1577100139i799918080"
    }
  ]
}

stateless integration

Operate it safely

request-response

This operation is evaluated independently from the request. Cache and retry according to its documented semantics.

Keep credentials and raw tokens out of source, client bundles, prompts, and logs.Record the operation ID, status, latency, retry count, and source contract version in traces.Classify 4xx responses before retrying; back off and add jitter for retryable 5xx or transport failures.Cache only when request inputs, authorization scope, and freshness requirements permit it.

Auditable source

Contract provenance

Source file: contenthub/dochub/mapmyindia-rest-api/docs/custom/textsearch.yml
SHA-256: afcd3c96db88abefe988018a2ef98ccb5e816c84beefc47bd0c9cd4452b365f6
Normalization: Fields are parsed from OpenAPI. Operational guidance and language samples are generated and labeled separately.
Source record: Open repository audit