X Twitter Searchspaces

60 credits/call
ae_x_twitter_searchspaces

Search Spaces by keyword and optionally filter by live or scheduled state.

SocialAudio
60 credits/call

Pricing

60 credits/call
ConditionCharge
Each call60 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
querystringYes搜索关键词。 Search keywords.—
stateenum (live | scheduled | all)NoSpace状态:live直播中、scheduled已预告、all全部。 Space state: live, scheduled or all.all
expansionsstringNo需要额外展开的关联对象,多个值用逗号分隔。可选值: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_resultsintegerNo可选,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.fieldsstringNo需要返回的字段,多个字段名用逗号分隔。可选值: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.fieldsstringNo需要返回的字段,多个字段名用逗号分隔。可选值: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.fieldsstringNo需要返回的字段,多个字段名用逗号分隔。可选值: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-Key
Request 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
JSONPartial content
{
  "data": [
    {
      "id": "1RKZzBZVLpgKB",
      "state": "live"
    }
  ],
  "meta": {
    "result_count": 27
  }
}

This example shows part of the response. Copied content is valid JSON.