X Twitter Searchspaces
60 credits/call
ae_x_twitter_searchspaces
Search Spaces by keyword and optionally filter by live or scheduled state.
60 credits/call
Pricing
60 credits/call
| Condition | Charge |
|---|---|
| Each call | 60 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索关键词。 Search keywords. | — |
state | enum (live | scheduled | all) | No | Space状态:live直播中、scheduled已预告、all全部。 Space state: live, scheduled or all. | all |
expansions | string | No | 需要额外展开的关联对象,多个值用逗号分隔。可选值:creator_id, host_ids, invited_user_ids, speaker_ids, topic_ids。 Comma-separated related objects to expand. Allowed values: creator_id, host_ids, invited_user_ids, speaker_ids, topic_ids. | — |
max_results | integer | No | 可选,1–100,指定本次最多返回的记录数量。省略时采用接口原默认上限100;实际结果可能更少。 Optional, from 1 to 100. Maximum records to return. Omit to use the endpoint default limit of 100; actual results may be fewer. | — |
user.fields | string | No | 需要返回的字段,多个字段名用逗号分隔。可选值:affiliation, created_at, description, entities, id, is_identity_verified, location, most_recent_tweet_id, name, parody, pinned_tweet_id, profile_banner_url, profile_image_url, protected, public_metrics, url, username, verified, verified_followers_count, verified_type, withheld。 Comma-separated fields to include in the response. Allowed values: affiliation, created_at, description, entities, id, is_identity_verified, location, most_recent_tweet_id, name, parody, pinned_tweet_id, profile_banner_url, profile_image_url, protected, public_metrics, url, username, verified, verified_followers_count, verified_type, withheld. | — |
space.fields | string | No | 需要返回的字段,多个字段名用逗号分隔。可选值:created_at, creator_id, ended_at, host_ids, id, invited_user_ids, is_ticketed, lang, participant_count, scheduled_start, speaker_ids, started_at, state, subscriber_count, title, topic_ids, updated_at。 Comma-separated fields to include in the response. Allowed values: created_at, creator_id, ended_at, host_ids, id, invited_user_ids, is_ticketed, lang, participant_count, scheduled_start, speaker_ids, started_at, state, subscriber_count, title, topic_ids, updated_at. | — |
topic.fields | string | No | 需要返回的字段,多个字段名用逗号分隔。可选值:description, id, name。 Comma-separated fields to include in the response. Allowed values: description, id, name. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_x_twitter_searchspaces' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"max_results": 100,
"query": "crypto",
"state": "all"
}
}'Response exampleresponse.json
{
"data": [
{
"id": "1RKZzBZVLpgKB",
"state": "live"
}
],
"meta": {
"result_count": 27
}
}This example shows part of the response. Copied content is valid JSON.





