Usage

Returns the full list of bizographic segments available through the API. Note: this response will be large (approximately 22k).

URL

http://api.bizographics.com/v2/taxonomy.format

Formats

json,xml,csv 

HTTP Method

GET 

Parameters

• api_key: Required.
• callback: Optional. Only available for json format. If supplied the response will use the JSONP format with the callback of the given name.

Response

This format is similar to the format described in Bizographic data format, but wrapped in a parent taxonomy object, and all groups will contain a list.

JSON

{"taxonomy": {
   "version": "20100115",
   "bizographics": {
     "company_size":[{"code":"micro", "name":"Micro"}, ...],
     "seniority":[{"code":"executive", "name":"Executive"}, ... ],
     "functional_area":[{"code":"marketing", "name":"Marketing"}, ...],
     "industry":[{"code":"advertising_and_marketing","name":"Advertising & Marketing","parent_code":"business_services"},{"code":"business_services","name":"Business Services"}]
   }
   "usage": 0
 }
}

XML

<result>
  <bizographics>
    <company_size>
      <segment>
        <code>micro</code>
        <name>Micro</name>
      </segment>
      <segment>
        <code>small</code>
        <name>Small</name>
      </segment>
    ...
    </company_size>
    <seniority>
      <segment>
        <code>board_member</code>
        <name>Board Member</name>
      <segment>
      <segment>
        <code>executive</code>
        <name>Executive</name>
      <segment>
    ...
    </seniority>
    <functional_area>
      <segment>
        <code>marketing</code>
        <name>Marketing</name>
      </segment>
    ...
    </functional_area>
    <industry>
      <segment>
        <code>advertising_and_marketing</code>
        <name>Advertising &amp; Marketing</name>
        <parent-code>business_services</parent-code>
      </segment>
      <segment>
        <code>business_services</code>
        <name>Business Services</name>
      </segment>
    ...
    </industry>
    ...
  </bizographics>
  <usage>0</usage>
</result>

CSV

"GROUP CODE","GROUP NAME","PARENT CODE","SEGMENT CODE","SEGMENT NAME"
"seniority","Seniority","","executive","Executives"
"seniority","Seniority","","mid_management","Mid-Management"
"industry","Industry","manufacturing","manufacturing_aerospace_and_defense","Mfg Aerospace & Defense"
"industry","Industry","","hospitality","Hospitality/Hotels"

...

 Example CSV API Call

To download a csv of the Bizo Taxonomy, simply cut and paste the link below into your browser and replace YOUR_API_KEY with your api key.

http://api.bizographics.com/v2/taxonomy.csv?api_key=YOUR_API_KEY