# Idea Hub API API

> Idea Hub API API on Apizie: 4 endpoints (Creates an idea activity entry., Update a topic state resource., List ideas for a given Creator and filter and sort options., Returns which locales ideas are available in for a given Creator.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/analytics:googleapis-ideahub/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-ideahub`
- Category: Analytics
- Status: byok
- Source: https://console.cloud.google.com/apis/library/ideahub.googleapis.com
- Page: https://apizie.tech/api/analytics/googleapis-ideahub
- OpenAPI: https://apizie.tech/api/analytics/googleapis-ideahub/openapi.json

This is an invitation-only API.

## Endpoints

### Creates an idea activity entry.
`POST https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-idea-activities-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | yes | Required. The parent resource where this idea activity will be created. Format: platforms/{platform}/property/{property} |
| body | object | yes | JSON request body |

### Update a topic state resource.
`POST https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-topic-states-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Unique identifier for the topic state. Format: platforms/{platform}/properties/{property}/topicStates/{topic_state} |
| updateMask | string | no | The list of fields to be updated. |
| body | object | yes | JSON request body |

### List ideas for a given Creator and filter and sort options.
`GET https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-ideas-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| filter | string | no | Allows filtering. Supported syntax: * Filter expressions are made up of one or more restrictions. * Restrictions are implicitly combined,… |
| orderBy | string | no | Order semantics described below. |
| pageSize | integer | no | The maximum number of ideas per page. If unspecified, at most 10 ideas will be returned. The maximum value is 2000; values above 2000 will… |
| pageToken | string | no | Used to fetch next page. |
| parent | string | yes | Required. If defined, specifies the creator for which to filter by. Format: publishers/{publisher}/properties/{property} |

### Returns which locales ideas are available in for a given Creator.
`GET https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-locales-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of locales to return. The service may return fewer than this value. If unspecified, at most 100 locales will be… |
| pageToken | string | no | A page token, received from a previous `ListAvailableLocales` call. Provide this to retrieve the subsequent page. When paginating, all… |
| parent | string | yes | Required. The web property to check idea availability for Format: platforms/{platform}/property/{property} |

## Example
```
curl "https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-idea-activities-create" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Idea Hub API API?
Create a free Apizie key, then send POST https://apizie.tech/v1/analytics:googleapis-ideahub/ideahub-platforms-properties-idea-activities-create with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Idea Hub API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Idea Hub API itself also needs your own key from googleapis.com.

### Can AI agents use the Idea Hub API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-ideahub.

### What is the status of the Idea Hub API API?
Needs your own provider key (bring your own key)