# Content API (RESTFul)

To pull content information from the our content Portal you can use Mobivate's Content API (RESTful).

This means that by making few simple HTTP GET Requests, you can retrieve the content information, including the images and record it on your own site for faster content retrieval while keeping your website content up-to-date.

### API Requests

For all requests to Content API, make the HTTP GET request to:

```hsts
https://content-api.mobivate.com/<version>/<account_id>/<method>
```

### Responses

We understand some programmers have preference of retrieving responses in XML while others may prefer JSON format. So, we offer both.

You can request the format you prefer in two ways:

By specifying the ''`Accepts: application-json`'' / ''`Accepts: application-xml`'' in the request or, by adding the ''`format=(json | xml)`'' parameter in the URL request string.

### Example Request&#x20;

```gettext
GET https://content-api.mobivate.com/v1/aaaaaabbbbbbcccccc/content_types/
```

### Example Response

```xml
<items>
  <item>Android Apps</item>
  <item>Cover Full Tracks</item>
  <item>Covertones</item>
  <item>Games</item>
  <item>J2ME</item>
  <item>Monophonics</item>
  <item>Polyphonics</item>
  <item>True Full Tracks</item>
  <item>TrueSounds</item>
  <item>TrueTones</item>
  <item>Videos</item>
  <item>Wallpapers</item>
</items>
```

### Parameters

Below are a list of parameters used for the content api requests:

| Parameter   | Description                                                                                                                                                                                          |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| version     | The version of the subscription api. Currently can only be `v1`.                                                                                                                                     |
| account\_id | Your unique Mobivate account id, for example: `0000d000a000d000c000e0f000b00`.                                                                                                                       |
| method      | <p>Which method you would like to call can be one of the following:  <code>content\_types</code>,</p><p><code>categories</code>, <code>search</code>, <code>latest</code> or <code>item.</code> </p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.mobivate.com/api-message-paramaters/content-api-restful.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.