World Postal Codes


Worldwide postal code search REST API. Nearest postal codes within a given distance. Find zip / postal code for a given place.


€9 / Month Login to upgrade 
            

                
                Search: 
                
                
            

                        Remaining Hits: 30 (this month from your IP)

                    

    

    
    
    

        


            

                
                 
                
                
                
                
                
                
                
                
                
                
            

            Remaining Hits: 30 (this month from your IP)

                                

        
    

    
    
    

        

            
            

                
API Key Info

                

                    
API KEY:
 GUEST_USER

                    
User ID:
 -1

                    
Remaining Hits:
 30 / 30 (requests per month)
                    


                                        €9 / Month                Login to upgrade
                        


                    

                

                
                
Get nearby locations for given lat,long coordinates

                

                    
What is it ?


                    
                        Returns all neighbouring locations worldwide for a given pair of lat,long coordinates.
                    
                    
                    

                    
Example API call (click, don't be shy):


                    
                        https://ezcmd.com/apps/api_ezip_locator/nearby_locations_by_coords/[API_KEY]/[USER_ID]
                    
                    
                    


                    
GET Parameters:


                    
                        
Mandatory:


                        coords=41.701627,-87.698364 // Latitude and Longitude pair of coordinates separated by comma.

                        
                        

                        
                        
Optional:


                        within=150 // The distance radius to search for neighbouring places within.

                        unit=Miles // Either Miles or Km (please mind the upper-case M and K).

                        group=place_name // Avoid duplicate results by grouping your results by any of the returned fields. Default grouping is by place_name. Group by id to get all zip codes.

                        start=0 // The results are paginated. The start offset. Limit is always 100.

                    
                

                
                
               


                
                
Get nearby locations for given zip / postal code

                

                    
What is it ?


                    
                        Returns all neighbouring locations worldwide for a given zip / postal code and country code.
                    
                    
                    

                    
Example API call (click, don't be shy):


                    
                        https://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_zip_code/[API_KEY]/[USER_ID]
                    
                    
                    


                    
GET Parameters:


                    
                        
Mandatory:


                        zip_code=75050 // The zip code you want to get neighbours for

                        country_code=US // The country code you want to get neighbours for


                        
                        
Optional:


                        within=150 // The distance radius to search for neighbouring places within.

                        unit=Miles // Either Miles or Km (please mind the upper-case M and K).

                        group=place_name // Avoid duplicate results by grouping your results by any of the returned fields. Default grouping is by place_name. Group by id to get all zip codes.

                        start=0 // The results are paginated. The start offset. Limit is always 100.

                    
                

                
                
                
Zip / Postal Code Search by location

                

                    
What is it ?


                    
                        Search worldwie postal / zip codes for any given fuzzy address, sate, country, etc...

                        Only returns top 150 matches.
                    
                    
                    

                    
                    
Example API call (click, don't be shy):


                    
                        https://ezcmd.com/apps/api_geo_postal_codes/search/[API_KEY]/[USER_ID]
                    
                    
                    
                    


                    
                    
GET Parameters:


                    
                        
Mandatory:


                        zip_query=Santa Clara, US // Just any fuzzy or fixed address or zip code you want to search for.

                    
                

                
                
            

            
        

    

    
    


    
    

        
        
Limits:

         
        

            

                Guest Lookups:
                 30 / Month
            

            

                FREE User Lookups:
                 190 / Month
            

                        

                Premium User Lookups:
                 99,999,900,000 / Month
                    

                                        €9 / Month                Login to upgrade
                        


                		
            

                    

        
    

    


    
















    

	
	

		
	
Comments

	
	
			
		

			

				Gravatar			

			

				

					

											

				

				

					
2018-03-29

				

				

											
Thanks it is now fixed.

									

			

		

			
		

			

				Gravatar			

			

				

					

						Tech Support					

				

				

					
2018-03-28

				

				

											
Hello David,



The bug has now been fixed. Please run your query again.

You should be able to see the total_records being reported correctly.



https://www.dropbox.com/s/l6wb5ya4keiuelz/Screenshot 2018-03-29 00.19.14.png?dl=0



Thank you.

									

			

		

			
		

			

				Gravatar			

			

				

					

						Tech Support					

				

				

					
2018-03-28

				

				

											
Hello David



Thank you for pointing this out. We're working at fixing this right now.



I'll let you know as soon as it's done.



Thank you.

									

			

		

			
		

			

				Gravatar			

			

				

					

											

				

				

					
2018-03-28

				

				

											
The returned data has null set for records_total. Is there any way to get that fixed to include that value?



https://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_zip_code/GUEST_USER/-1?zip_code=110044&country_code=IN&unit=Miles&within=50&start=0

									

			

		

			
		

			

				Gravatar			

			

				

					

						Tech Support					

				

				

					
2018-03-16

				

				

											
Please use the API:

https://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_zip_code/GUEST_USER/-1?zip_code=110044&country_code=IN&unit=Miles&within=50&start=0



And then, to get the next 50, you call:



https://ezcmd.com/apps/api_geo_postal_codes/nearby_locations_by_zip_code/GUEST_USER/-1?zip_code=110044&country_code=IN&unit=Miles&within=50&start=50 



And so on. The API has pagination.



									

			

		

			
		

			

				Gravatar			

			

				

					

											

				

				

					
2018-03-16

				

				

											
Hi,

When i try to find Nearest postal codes within a given distance.



it is return only 22 records. but it should be large number city.

it tried with multiple pincode. like : 110044 radius is 50.

Thanks,

Amit

									

			

		

			
		

			

				Gravatar			

			

				

					

						Tech Support					

				

				

					
2018-02-28

				

				

											
That should be fixed now.

https://ezcmd.com/apps/app_geo_postal_codes?action=webapi&zip_query=685581



Thanks!

									

			

		

			
		

			

				Gravatar			

			

				

					

						Achu					

				

				

					
2016-05-12

				

				

											
I am not getting the result for the postal code 682037,685581

									

			

		

		

	


	


		
Post a comment