Use these requests to retrieve demographics information about your subscribers.

Subscriber Demographics

This request returns the demographics data that is associated with a subscriber.

Data Element	Type	Length	Conditional	Description
Count	Int			Number of matches based on criteria
subscriber_id	Int		True	Unique Subscriber ID
subscriber_demographics_id	Int		True	Unique Subscriber Demographic ID
demographic_id	Int		True	Unique Demographic ID
demographic_name	String	255	True	Demographic Name
demographic_category_id	Int		True	Demographic Category ID
demographic_category_name	String	255	True	Demographic Category Name
Email	String	100	True	Email address
user_id	String	255	True	Unique remote ID

Request

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
 <Brand id="9999">Test Brand</Brand>
 <User></User>
 <Grids>
  <Grid type="subscriber_demographics">
   <ReturnFields>
    <DataElement>demographic_category_id</DataElement>
    <DataElement>demographic_category_name</DataElement>
    <DataElement>demographic_id</DataElement>
    <DataElement>demographic_name</DataElement>
    <DataElement>subscriber_demographics_id</DataElement>
   </ReturnFields>
  </Grid>
 </Grids>
</GridRequest>

Subscriber Extended Demographic

This request returns "extended" demographics data.

Data Element	Type	Length	Conditional	Description
subscriber_id	Int		True	Unique Subscriber ID
remote_id	String	50	True	Subscriber ID for the remote system
subscriber_email	String	-1	True	Subscriber Email Address
category_id	Int		True	Unique Demographic Category ID
category_name	String	255	True	Demographic Category Name
demographic_id	Int		True	Unique Demographic ID
demographic_name	String	255	True	Demographic Name
category_extended_field_name	String	100	True	Demographic Category Extended Field Name
category_extended_field_value	String	100	True	Demographic Category Extended Field Value

Request

<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
 <Password></Password>
 <Brand id="9999">Test Brand </Brand>
 <User></User>
 <Grids>
  <Grid type="subscriber_extended_demographic">
   <Conditions>
    <Condition>
     <Single>
      <DataElement>subscriber_id</DataElement>
      <DataValue>525108846</DataValue>
      <Comparator>EQ</Comparator>
     </Single>
    </Condition>
    <Condition>
     <Single>
      <DataElement>category_id</DataElement>
      <DataValue>1759</DataValue>
      <Comparator>EQ</Comparator>
     </Single>
    </Condition>
   </Conditions>
   <ReturnFields>
    <DataElement>subscriber_id</DataElement>
    <DataElement>remote_id</DataElement>
    <DataElement>subscriber_email</DataElement>
    <DataElement>is_unsubscriber</DataElement>
    <DataElement>category_id</DataElement>
    <DataElement>category_name</DataElement>
    <DataElement>demographic_id</DataElement>
    <DataElement>demographic_name</DataElement>
    <DataElement>category_extended_field_name</DataElement>
    <DataElement>category_extended_field_name</DataElement>
   </ReturnFields>
  </Grid>
 </Grids>
</GridRequest>

Response

<?xml version="1.0" encoding="utf-8"?>
<GridResponse xmlns="http://partner.informz.net/aapi/2009/08/">
 <Brand id="9999">Test Brand</Brand>
 <User></User>
 <Grids>
  <Grid type="subscriber_extended_demographic">
   <Record row="1">
    <Fields>
     <Field element="subscriber_id">525108846</Field>
     <Field element="remote_id" />
     <Field element="subscriber_email"></Field>
     <Field element="is_unsubscriber">0</Field>
     <Field element="category_id">1759</Field>
     <Field element="category_name">Extended test - school</Field>
     <Field element="demographic_id">27977</Field>
     <Field element="demographic_name">Ukraine</Field>
     <Field element="category_extended_field_name">Primary</Field>
     <Field element="category_extended_field_value">"Pervocvit"</Field>
    </Fields>
   </Record>
   <Record row="2">
    <Fields>
     <Field element="subscriber_id">525108846</Field>
     <Field element="remote_id" />
     <Field element="subscriber_email"></Field>
     <Field element="is_unsubscriber">0</Field>
     <Field element="category_id">1759</Field>
     <Field element="category_name">Extended test - school</Field>
     <Field element="demographic_id">27977</Field>
     <Field element="demographic_name">Ukraine</Field>
     <Field element="category_extended_field_name">Secondary</Field>
     <Field element="category_extended_field_value">#96</Field>
    </Fields>
   </Record>
   <Record row="3">
    <Fields>
     <Field element="subscriber_id">525108846</Field>
     <Field element="remote_id" />
     <Field element="subscriber_email"></Field>
     <Field element="is_unsubscriber">0</Field>
     <Field element="category_id">1759</Field>
     <Field element="category_name">Extended test - school</Field>
     <Field element="demographic_id">27977</Field>
     <Field element="demographic_name">Ukraine</Field>
     <Field element="category_extended_field_name">National</Field>
     <Field element="category_extended_field_value">LNU</Field>
    </Fields>
   </Record>
  </Grid>
 </Grids>
</GridResponse>

GridRequests - Subscriber Demographics and Extended Demographic

Subscriber Demographics

Request

Subscriber Extended Demographic

Request

Response

Can’t find what you’re looking for?