Features:
Competitive pricing
No set-up Charges
Over 99.99% Availability
Free Trial Software
Free Technical Support
Try before you buy
Local or Internet Data
Reseller Opportunities
    Postcode finder using data supplied by royal mail
Updated Daily

Postcode Programming API  Get Full Address using Advanced/Word Search:


The HTTP/XML Web Service also supports our advanced/word search when used for Internal Use. This allows the user to enter partial address words to find the full address in the Royal Mail Postcode Address file.

The principle, of searching, is very similar to the Full Address Postcode Finder described in section above.  Except it has more parameters.

Step 1 Sign up for trial

Simply use the "Sign Up for Trial" link at top right of this page to open a trial account.   We will then send you a data key, which is used to identify your account, when using the following service.

Step 2 Search for matching data and display

To perform an advanced search, two of the following fields should be filled in with criteria

  One or more of the following:

Parameter nameDescription
organistaionEnter most distinctive word of Organisation name. Start of words can be entered by using *
For example “StartOfWord*”
buildingornumberEnter most distinctive word of Building Name or number. Start of words can be entered by using *
For example “StartOfWord*”
streetEnter most distinctive word of Street/Road or Avenue Name. Start of words can be entered by using *
For example “StartOfWord*”

  And one of the following from a selection list:

Parameter nameDescription
townorvillageTown or village name selected from a list
countyCounty name selected from a list
postareaStart of Postcode (Outer Postcode) selected from a list

The XML list of TownOrVillage, County, and Postcode Outer can be downloaded from URL:

  http://www.simplylookupadmin.co.uk/XMLService/GetLookups.aspx?datatype=1

This list should be written to a local store, and displayed for user to select from.

video  Tutorial Video : Show Advanced Search in Action

Returns

<errormessage> should be displayed if populated

If <recordcount>0</recordcount> then nothing found

If <recordcount>100</recordcount> then you need to refine the search query since this query will return a maximum of 100 lines. In which case you should add a line to the list saying “Gone over limit of 100 lines, please refine search....”. To test this set to organisation=”tesco” and townorvillage=”London”

  Note: Only the first 100 lines of advanced search results are returned. In which case the criteria should be refined.

  This type of search is only available to “Internal use” type of license

Example

www.simplylookupadmin.co.uk/XMLservice/XMLSearchForAddress.aspx?datakey=Your Data Key &organistaion=Tesco&buildingornumber=&street=&townorvillage=&county=Cambridgeshire&pobox=&postarea=

   Returns

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
   <!DOCTYPE data [
   <!ELEMENT data(found,credits_ display_text, accountadminpage,
                                     errormessage,maxresults,recordcount,addressdata)>
   <!ELEMENT found (#PCDATA)>
   <!ELEMENT credits_display_text (#PCDATA)>
   <!ELEMENT accountadminpage (#PCDATA)>
   <!ELEMENT errormessage (#PCDATA)>
   <!ELEMENT maxresults (#PCDATA)>
   <!ELEMENT recordcount (#PCDATA)>
   <!ELEMENT addressdata (record*)>
   <!ELEMENT record (l,id)>
   <!ELEMENT l (#PCDATA)>
   <!ELEMENT id (#PCDATA)>
]>
<data>
   <found>1</found>
   <credits_display_text>Evaluation till 3 Apr 2011</credits_display_text>
   <accountadminpage>https://www.simplylookupadmin.co.uk/WebAccountLogin.aspx?
                        doid=1&amp;coid=3333305462&amp;Pay=yes</accountadminpage>
   <errormessage></errormessage>
   <maxresults>99</maxresults>
   <recordcount>4</recordcount>
   <addressdata>
      <record><l>Tesco Barford Road St. Neots Cambridgeshire PE19 2SA England</l>
               <id>31567757_2957290S_F</id></record>
      <record><l>Tesco 2-10 Staniland Way Peterborough Cambridgeshire PE4 6NA England</l>
               <id>29530895_1945471S_F</id></record>
      <record><l>Tesco Extra Serpentine Green The Serpentine Peterborough PE7 8BD England</l>
               <id>2104076_0L_F</id></record>
      <record><l>Tesco 1 Market Rise Cherry Hinton Road Cambridge Cambridgeshire CB1 7DZ England</l>
               <id>33896480_2938173S_F</id></record>

   </addressdata>
</data>

 

If used by employee of company (classed as "Internal use")

It is a requirement of the royal mail that if postcode lookup software is used by an employee of a company, then the user must be uniquely identified so we can apply a user count.

Therefore the URL must contain a User ID:

www.simplylookupadmin.co.uk/XMLservice/XMLSearchForAddress.aspx?datakey=Your Data Key &organistaion=Tesco&buildingornumber=&street=&townorvillage=&county=Cambridgeshire&pobox=&postarea= &username=UserID

This will be the datakey beginning with "I"

Section 3.5 of the Terms and Conditions state: "The Customer, when using the Postcode Lookup service via Web Service, must make sure each user is identified by a unique Computer name, in each call to the Web Service if used internally”. In simple language this means that each user must be identified by a unique computer name, in username parameter, if used by a company employee.

Step 4 Get Address record based on record select

When the users selects a record then simply get it using the sames call as in step 3 of the "Full Address" search.