API URL: http://api.allcompanyonline.com/web_search/v1/company.php
Getting Started
Abstract
AllCompanyOnline API (ACO API) is an initiative in AllCompanyOnline.com search infrastructure and enable third parties to build revolutionary search products leveraging their own data, content, technology, social graph, or other assets. This release includes Company Profile search.
Key Information
You will need to obtain an APP ID before you can start using ACO API. During the beta testing, please register your key at Here.
Who Should Read This Document
This manual is intended for programmers developing applications to access the ACO API. The manual assumes an understanding of HTTP, XML, and a cursory knowledge of query languages.
Contact Information
If you have any technical related questions, please do email us at info@allcompanyonline.com
Sample Full Query: http://api.allcompanyonline.com/web_search/v1/company.php?country=CN&searchtype=company&searchkey=computer&count=20&appid={appid}
There are 3 different search types
1) company : searching of company name, profile, remark
2) address : searching for address
3) contactnumber : searching for telephone number and fax number For the beta testing, we only enable the company search type.
searchkey*
The keyword you wish to search and use '+' to replace the empty place. Please only allow alphabet and character. Cannot exceed 255 characters
start
It shows from where the records start displaying. If it is NULL, it will display from the first records.
appid*
You will need to option your own APP ID. The APP ID only allow a maximum of 500 query per day. If you wish to have a great access, please do contact us directly.
During the beta testing, you could use our general APP ID.
* Note : It is all required field.
- Note : You can only perform 200 times web search per day during the beta period.
Response Field
This section describes the response fields returned by web search. Following is the XML Header
Field Name
Description
responsecode
If the query is valid and successful, it will display "200". If error, it will return "400".
nextpage
It will display a complete web search request url for next page result
start
It shows from where the records start displaying. If it is NULL, it will display from the first records.
totalrecords
Total number of records for the query
count
The number of records shown. It is 10 by default.
company
Company Name
profile
Profile
address
Full Address
telephone
Telephone Number
fax
Fax Number
contactperson
Contact Person
website
Website for the company
detailurl
For detail information, you will need to access to this page. It will point to our main site.
errorcode
If responsecode is "400", it will display error code with the following number
1) 401 : Country Name is empty
2) 402 : Country Name is invalid
3) 403 : Search type is Invalid
4) 404 : Search key is empty
5) 405 : Search key is invalid. Please enter more than 4 characters
6) 406 : Search key is invalid. Please enter less than 255 characters
6) 407 : APP ID is empty
7) 408 : APP ID is invalid
8) 409 : Your Daily Access Limit has been exceeded.
To offer the best performance for system, we have limit the API only display 10 results per pages.
Sample XML Response
<allcompanyonlineresponse responsecode="200">
<nextpage>
http://api.allcompanyonline.com/web_search/v1/company.php?country=CN&searchtype=company
&searchkey=computer&start=30&appid=a
</nextpage>
<resultset_web count="10" start="20" totalrecords="401">
<result>
<company>Sassin International Electric Co., Ltd.</company>
<profile>
Sassin International Electric Co., Ltd. is one of the largest industrial electric
manufacturers in China and is a boundless international enterprise, which specially
develops, manufactures and sells the world leading level high and low voltage
electrics and element, transmit distribution equipment, power equipment, instrument
and meter, building electric, Automation, wire and cable, electricity and electric
equipment etc.
</profile>
<address>
NO.2588 JINHAI ROAD, PUDONG, SHANGHAI, CHINA, 201209, Shanghai City,
</address>
<telephone>021-50218008</telephone>
<fax>021-50210119</fax>
<contactperson>m.r huang</contactperson>
<website>www.sassin.com</website>
<detailurl>
http://www.allcompanyonline.com/company/2/25/68/935/Sassin-International-.html
</detailurl>
</result>
</resultset_web>
</allcompanyonlineresponse>
Country Code Description
As we have predefined the country code for the query string, please use the following country code accordingly or else it will prompt for error. As a control on the system, we do not allow searching on all the country at one query. You will only be able to search on a specific country database.
Malaysia Company Information, Indonesia Company Information, China Company Information, India Company Information, Australia Company Information, Pakistan Company Information, Iran Company Information, Turkey Company Information, US Company Information, Vietname Company Information, Business, Trade, Online Business Directory and etc.
