Developers & API: Interests

Get a list of interests

Get a list of interests for an individual keyword

URL:

http://api.optitmobile.com/1/keywords/{keyword_id}/interests.{format}

Format:

xml, json

HTTP Method:

GET

Parameters:

• name - name of the interest
• page - the number of the page result that you are requesting.

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<interests type="array" current_page="1" total_pages="1">
    <interest >
        <id>123456</id>
        <name>interest</name>
        <description>interest description</description>
        <status>active</status>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
        <mobile_subscription_count>1234</mobile_subscription_count>
        <url>http://api.optitmobile.com/1/interests/{interest_id}.{format}</url>
        <url_interest_subscriptions>http://api.optitmobile.com/1/interests/{interest_id}/subscriptions.
        {format}</url_interest_subscriptions>
    </interest>
    <interest>
        ......
    </interest>
</interests>

Get a list of interests by phone number

Get a list of interests for an individual keyword and subscribers phone number

URL:

http://api.optitmobile.com/1/keywords/{keyword_id}/subscriptions/{phone}/interests.{format}

Format:

xml, json

HTTP Method:

GET

Parameters:

• page - the number of the page result that you are requesting.

XML Response

<?xml version="1.0" encoding="UTF-8"?>
<interests type="array" current_page="1" total_pages="1">
    <interest >
        <id>123456</id>
        <name>interest</name>
        <description>interest description</description>
        <status>active</status>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
        <mobile_subscription_count>1234</mobile_subscription_count>
        <url>http://api.optitmobile.com/1/interests/{interest_id}.{format}</url>
        <url_interest_subscriptions>http://api.optitmobile.com/1/interests/{interest_id}/subscriptions.
        {format}</url_interest_subscriptions>
    </interest>
    <interest>
        ......
    </interest>
</interests>

Get an individual interest

Get an individual interest for a keyword

URL:

http://api.optitmobile.com/1/interests/{interest_id}.{format}

Format:

xml, json

HTTP Method:

GET

XML Response

<?xml version="1.0" encoding="UTF-8"?>
    <interest>
        <id>123456</id>
        <name>interest</name>
        <description>interest description</description>
        <status>active</status>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
        <mobile_subscription_count>1234</mobile_subscription_count>
        <url_interest_subscriptions>http://api.optitmobile.com/1/interests/{interest_id}/subscriptions.
        {format}</url_interest_subscriptions>
    </interest>

Create a new interest

Create a new interest associated to a keyword.

URL:

http://api.optitmobile.com/1/keywords/{keyword_id}/interests.{format}

Format:

xml, json

HTTP Method:

POST

Parameters:

• name - name of the interest. (Required)
• description - description of the interest

XML Response

<?xml version="1.0" encoding="UTF-8"?>
    <interest >
        <id>123456</id>
        <name>interest</name>
        <description>interest description</description>
        <status>active</status>
        <created_at >06/10/04 10:40 AM Central Standard Time</created_at>
    </interest>