> For the complete documentation index, see [llms.txt](https://wiki.mobivate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.mobivate.com/api-message-paramaters/content-api-restful.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
