# Xingtu creator homepage videos by creator id

Lists a Douyin Creator Marketplace (Xingtu) creator's homepage videos with keyword, video-type, assignment, date, and page filters.

|  |  |
| --- | --- |
| Tool id | `justoneapi.x-douyin-xingtu-gwaggregator-get-author-homepage-videos-v1` |
| Platform | [Douyin Xingtu](https://www.orcarouter.ai/tools/xingtu.md) |
| Capability | [Property listings](https://www.orcarouter.ai/tools/xingtu/property-listings.md) |
| Price | $0.08118 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | yes |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `oAuthorId` | string | yes | Author's unique Xingtu ID. |
| `endDate` | string | no | End publish date in yyyyMMdd format. The filter ends at 23:59:59 in Asia/Shanghai. |
| `keyword` | string | no | Keyword used to search creator homepage videos. |
| `onlyAssign` | boolean | no | Whether to include only assigned videos. Xingtu usually shows this option when \`videoType\` is \`XINGTU\`. |
| `page` | integer | no | Page number, starting from 1. |
| `startDate` | string | no | Start publish date in yyyyMMdd format. The filter starts at 00:00:00 in Asia/Shanghai. |
| `videoType` | string | no | Homepage video type filter. Available Values: - \`ALL\`: All videos - \`PERSONAL\`: Personal videos - \`XINGTU\`: Xingtu videos One of: ALL, PERSONAL, XINGTU. |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-xingtu-gwaggregator-get-author-homepage-videos-v1/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"oAuthorId":"<oAuthorId>"}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-xingtu-gwaggregator-get-author-homepage-videos-v1/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{"oAuthorId":"<oAuthorId>"}},
)
print(resp.json())
```

## FAQ

### How much does Xingtu creator homepage videos by creator id cost?

Xingtu creator homepage videos by creator id costs $0.08118 per call: 1,000 calls cost $81.18.

### What does a $10 budget buy with Xingtu creator homepage videos by creator id?

About 123 calls at $0.08118 per call.

### What inputs does Xingtu creator homepage videos by creator id need?

Required inputs: oAuthorId.

### How do I call Xingtu creator homepage videos by creator id?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/xingtu/property-listings/x-douyin-xingtu-gwaggregator-get-author-homepage-videos-v1