← Back to Skills Marketplace
jaencarrodine

X (Twitter) API

by Jaen · GitHub ↗ · v1.0.13 · MIT-0
cross-platform ✓ Security Clean
142
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install agntdata-x
Description
X (Twitter) API integration with a single agntdata API key (Bearer token). Read tweets, user profiles, followers, search, lists, trends, and hashtags. Use th...
README (SKILL.md)

X (Twitter) API

The agntdata X API wraps X surface areas into a single integration. Instead of managing multiple keys, proxies, and rate limits yourself, you call agntdata with one credential and consume structured JSON optimized for downstream AI and analytics. Whether you are building a social listening agent, a content research pipeline, or a creator-intelligence product, this API gives you consistent access to tweets, user profiles, followers, search, and hashtag streams with predictable billing and operational simplicity.

Recommended: Install the Plugin

For the best experience, install the OpenClaw plugin for X (Twitter) API instead of this skill. The plugin provides native MCP tools, automatic authentication, and structured parameter validation.

Skill (this document):

clawhub install agntdata-x

Plugin (native tools; npm package matches package.json):

openclaw plugins install @agntdata/openclaw-x

This skill is useful for environments where plugins are not supported.

Authentication

Before making API calls, you need an API key. Get one from the agntdata dashboard.

The API key should be available as the AGNTDATA_API_KEY environment variable. Every request must include it as a Bearer token:

Authorization: Bearer $AGNTDATA_API_KEY

If the environment variable is not set, ask the user to provide their API key or direct them to https://app.agntdata.dev/dashboard to create one.

API Key Activation

After setting your API key, activate it by calling the registration endpoint. This only needs to be done once per key:

curl -X POST https://api.agntdata.dev/v1/register \
  -H "Authorization: Bearer $AGNTDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"intendedApis": ["x"], "useCase": "Brief description of your use case"}'

Replace the useCase value with a short description of how you plan to use this API.

Discovery Endpoints

These public endpoints (no API key required) let you explore this platform's capabilities:

curl https://api.agntdata.dev/v1/platforms/x

Returns: full endpoint list, OpenAPI spec, features, and use cases.

Base URL

https://api.agntdata.dev/v1/x

Available Endpoints

Method Path Summary
GET /user/medias/continuation Continuation User's Media
POST /user/medias/continuation Continuation User's Media
GET /user/medias User's Media
POST /user/medias User's Media
GET /user/likes/continuation Continuation User's Likes
POST /user/likes/continuation Continuation User's Likes
GET /user/likes User's Likes
POST /user/likes User's Likes
GET /user/followers/continuation Continuation User's Followers
POST /user/followers/continuation Continuation User's Followers
GET /user/followers User's Followers
POST /user/followers User's Followers
GET /user/following/continuation User's Following Continuation
POST /user/following/continuation User's Following Continuation
GET /user/tweets User's Tweets
POST /user/tweets User's Tweets
GET /user/tweets/continuation User's Tweets Continuation
POST /user/tweets/continuation User's Tweets Continuation
GET /user/details User Details
POST /user/details User Details
GET /user/about User About
GET /tweet/replies/continuation Tweet Replies Continuation
POST /tweet/replies/continuation Tweet Replies Continuation
GET /tweet/favoriters/continuation Tweet User Favoriters Continuation
GET /tweet/retweets/continuation Tweet User Retweets Continuation
GET /tweet/details Tweet Details
POST /tweet/details Tweet Details
GET /tweet/favoriters Tweet User Favoriters
GET /tweet/retweets Tweet User Retweets
GET /tweet/replies Tweet Replies
POST /tweet/replies Tweet Replies
GET /user/following User's Following
POST /user/following User's Following
GET /lists/tweets/continuation Lists Tweets Continuation
GET /search/search/continuation Search Continuation
POST /search/search/continuation Search Continuation
GET /ai/topic-classification Topic Classification
POST /translate/detect Detect
GET /ai/named-entity-recognition Named Entity Recognition
GET /ai/sentiment-analysis Sentiment Analysis
POST /translate Translate
GET /trends/available Available Locations (Beta)
GET /trends/ Get trends near a location (Beta)
GET /search/geo Geo Search (Beta)
GET /lists/tweets Lists Tweets
GET /lists/details Lists Details
GET /search/search Search
POST /search/search Search
GET /hashtag/hashtag Hashtag
POST /hashtag/hashtag Hashtag
GET /hashtag/hashtag/continuation Hashtag Continuation
POST /hashtag/hashtag/continuation Hashtag Continuation

Tool Schemas

The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.

[
  {
    "name": "agntdata_x_Continuation_User_s_Media_get__user_medias_continuation",
    "description": "Continuation User's Media",
    "method": "GET",
    "path": "/user/medias/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Media_post__user_medias_continuation",
    "description": "Continuation User's Media",
    "method": "POST",
    "path": "/user/medias/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Media_get__user_medias",
    "description": "User's Media",
    "method": "GET",
    "path": "/user/medias",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Media_post__user_medias",
    "description": "User's Media",
    "method": "POST",
    "path": "/user/medias",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Likes_get__user_likes_continuation",
    "description": "Continuation User's Likes",
    "method": "GET",
    "path": "/user/likes/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Likes_post__user_likes_continuation",
    "description": "Continuation User's Likes",
    "method": "POST",
    "path": "/user/likes/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Likes_get__user_likes",
    "description": "User's Likes",
    "method": "GET",
    "path": "/user/likes",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Likes_post__user_likes",
    "description": "User's Likes",
    "method": "POST",
    "path": "/user/likes",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Followers_get__user_followers_continuation",
    "description": "Continuation User's Followers",
    "method": "GET",
    "path": "/user/followers/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id",
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_Continuation_User_s_Followers_post__user_followers_continuation",
    "description": "Continuation User's Followers",
    "method": "POST",
    "path": "/user/followers/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Followers_get__user_followers",
    "description": "User's Followers",
    "method": "GET",
    "path": "/user/followers",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Followers_post__user_followers",
    "description": "User's Followers",
    "method": "POST",
    "path": "/user/followers",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Following_Continuation_get__user_following_continuation",
    "description": "User's Following Continuation",
    "method": "GET",
    "path": "/user/following/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token",
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Following_Continuation_post__user_following_continuation",
    "description": "User's Following Continuation",
    "method": "POST",
    "path": "/user/following/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_get__user_tweets",
    "description": "User's Tweets",
    "method": "GET",
    "path": "/user/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "include_pinned": {
          "type": "boolean",
          "description": "include_pinned"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "username": {
          "type": "string",
          "description": "username"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_post__user_tweets",
    "description": "User's Tweets",
    "method": "POST",
    "path": "/user/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "include_pinned": {
          "type": "boolean",
          "description": "include_pinned"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_Continuation_get__user_tweets_continuation",
    "description": "User's Tweets Continuation",
    "method": "GET",
    "path": "/user/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      },
      "required": [
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Tweets_Continuation_post__user_tweets_continuation",
    "description": "User's Tweets Continuation",
    "method": "POST",
    "path": "/user/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "include_replies": {
          "type": "boolean",
          "description": "include_replies"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_Details_get__user_details",
    "description": "User Details",
    "method": "GET",
    "path": "/user/details",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        },
        "user_id": {
          "type": "string",
          "description": "user_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_Details_post__user_details",
    "description": "User Details",
    "method": "POST",
    "path": "/user/details",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_About_get__user_about",
    "description": "User About",
    "method": "GET",
    "path": "/user/about",
    "parameters": {
      "type": "object",
      "properties": {
        "username": {
          "type": "string",
          "description": "username"
        }
      },
      "required": [
        "username"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_Continuation_get__tweet_replies_continuation",
    "description": "Tweet Replies Continuation",
    "method": "GET",
    "path": "/tweet/replies/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_Continuation_post__tweet_replies_continuation",
    "description": "Tweet Replies Continuation",
    "method": "POST",
    "path": "/tweet/replies/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Favoriters_Continuation_get__tweet_favoriters_continuation",
    "description": "Tweet User Favoriters Continuation",
    "method": "GET",
    "path": "/tweet/favoriters/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Retweets_Continuation_get__tweet_retweets_continuation",
    "description": "Tweet User Retweets Continuation",
    "method": "GET",
    "path": "/tweet/retweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "continuation_token",
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Details_get__tweet_details",
    "description": "Tweet Details",
    "method": "GET",
    "path": "/tweet/details",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Details_post__tweet_details",
    "description": "Tweet Details",
    "method": "POST",
    "path": "/tweet/details",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Favoriters_get__tweet_favoriters",
    "description": "Tweet User Favoriters",
    "method": "GET",
    "path": "/tweet/favoriters",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_User_Retweets_get__tweet_retweets",
    "description": "Tweet User Retweets",
    "method": "GET",
    "path": "/tweet/retweets",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_get__tweet_replies",
    "description": "Tweet Replies",
    "method": "GET",
    "path": "/tweet/replies",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      },
      "required": [
        "tweet_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Tweet_Replies_post__tweet_replies",
    "description": "Tweet Replies",
    "method": "POST",
    "path": "/tweet/replies",
    "parameters": {
      "type": "object",
      "properties": {
        "tweet_id": {
          "type": "string",
          "description": "tweet_id"
        }
      }
    }
  },
  {
    "name": "agntdata_x_User_s_Following_get__user_following",
    "description": "User's Following",
    "method": "GET",
    "path": "/user/following",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "string",
          "description": "user_id"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        }
      },
      "required": [
        "user_id"
      ]
    }
  },
  {
    "name": "agntdata_x_User_s_Following_post__user_following",
    "description": "User's Following",
    "method": "POST",
    "path": "/user/following",
    "parameters": {
      "type": "object",
      "properties": {
        "user_id": {
          "type": "integer",
          "description": "user_id"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Lists_Tweets_Continuation_get__lists_tweets_continuation",
    "description": "Lists Tweets Continuation",
    "method": "GET",
    "path": "/lists/tweets/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "list_id": {
          "type": "string",
          "description": "list_id"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      },
      "required": [
        "list_id",
        "continuation_token"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_Continuation_get__search_search_continuation",
    "description": "Search Continuation",
    "method": "GET",
    "path": "/search/search/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "end_date": {
          "type": "string",
          "description": "end_date"
        },
        "min_likes": {
          "type": "number",
          "description": "min_likes"
        },
        "start_date": {
          "type": "string",
          "description": "YYYY-MM-DD"
        },
        "min_replies": {
          "type": "number",
          "description": "min_replies"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "min_retweets": {
          "type": "number",
          "description": "min_retweets"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "continuation_token",
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_Continuation_post__search_search_continuation",
    "description": "Search Continuation",
    "method": "POST",
    "path": "/search/search/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "min_likes": {
          "type": "integer",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "integer",
          "description": "min_retweets"
        },
        "start_date": {
          "type": "string",
          "description": "start_date"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Topic_Classification_get__ai_topic_classification",
    "description": "Topic Classification",
    "method": "GET",
    "path": "/ai/topic-classification",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Detect_post__translate_detect",
    "description": "Detect",
    "method": "POST",
    "path": "/translate/detect",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Named_Entity_Recognition_get__ai_named_entity_recognition",
    "description": "Named Entity Recognition",
    "method": "GET",
    "path": "/ai/named-entity-recognition",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Sentiment_Analysis_get__ai_sentiment_analysis",
    "description": "Sentiment Analysis",
    "method": "GET",
    "path": "/ai/sentiment-analysis",
    "parameters": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "text"
        }
      },
      "required": [
        "text"
      ]
    }
  },
  {
    "name": "agntdata_x_Translate_post__translate",
    "description": "Translate",
    "method": "POST",
    "path": "/translate",
    "parameters": {
      "type": "object",
      "properties": {
        "dest": {
          "type": "string",
          "description": "dest"
        },
        "text": {
          "type": "string",
          "description": "text"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Available_Locations___Beta__get__trends_available",
    "description": "Available Locations (Beta)",
    "method": "GET",
    "path": "/trends/available",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "agntdata_x_Get_trends_near_a_location__Beta__get__trends",
    "description": "Get trends near a location (Beta)",
    "method": "GET",
    "path": "/trends/",
    "parameters": {
      "type": "object",
      "properties": {
        "woeid": {
          "type": "string",
          "description": "woeid"
        }
      },
      "required": [
        "woeid"
      ]
    }
  },
  {
    "name": "agntdata_x_Geo_Search___Beta__get__search_geo",
    "description": "Geo Search (Beta)",
    "method": "GET",
    "path": "/search/geo",
    "parameters": {
      "type": "object",
      "properties": {
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "range": {
          "type": "string",
          "description": "range"
        },
        "longitude": {
          "type": "string",
          "description": "longitude"
        },
        "latitude": {
          "type": "string",
          "description": "latitude"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Lists_Tweets_get__lists_tweets",
    "description": "Lists Tweets",
    "method": "GET",
    "path": "/lists/tweets",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "list_id": {
          "type": "string",
          "description": "list_id"
        }
      },
      "required": [
        "list_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Lists_Details_get__lists_details",
    "description": "Lists Details",
    "method": "GET",
    "path": "/lists/details",
    "parameters": {
      "type": "object",
      "properties": {
        "list_id": {
          "type": "string",
          "description": "list_id"
        }
      },
      "required": [
        "list_id"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_get__search_search",
    "description": "Search",
    "method": "GET",
    "path": "/search/search",
    "parameters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "limit"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "start_date": {
          "type": "string",
          "description": "YYYY-MM-DD"
        },
        "min_likes": {
          "type": "number",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "number",
          "description": "min_retweets"
        },
        "query": {
          "type": "string",
          "description": "query"
        },
        "end_date": {
          "type": "string",
          "description": "end_date"
        },
        "min_replies": {
          "type": "number",
          "description": "min_replies"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "agntdata_x_Search_post__search_search",
    "description": "Search",
    "method": "POST",
    "path": "/search/search",
    "parameters": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "query"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "min_likes": {
          "type": "integer",
          "description": "min_likes"
        },
        "min_retweets": {
          "type": "integer",
          "description": "min_retweets"
        },
        "start_date": {
          "type": "string",
          "description": "start_date"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Hashtag_get__hashtag_hashtag",
    "description": "Hashtag",
    "method": "GET",
    "path": "/hashtag/hashtag",
    "parameters": {
      "type": "object",
      "properties": {
        "section": {
          "type": "string",
          "description": "section"
        },
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        }
      },
      "required": [
        "hashtag"
      ]
    }
  },
  {
    "name": "agntdata_x_Hashtag_post__hashtag_hashtag",
    "description": "Hashtag",
    "method": "POST",
    "path": "/hashtag/hashtag",
    "parameters": {
      "type": "object",
      "properties": {
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        }
      }
    }
  },
  {
    "name": "agntdata_x_Hashtag_Continuation_get__hashtag_hashtag_continuation",
    "description": "Hashtag Continuation",
    "method": "GET",
    "path": "/hashtag/hashtag/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        },
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "string",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        }
      },
      "required": [
        "continuation_token",
        "hashtag"
      ]
    }
  },
  {
    "name": "agntdata_x_Hashtag_Continuation_post__hashtag_hashtag_continuation",
    "description": "Hashtag Continuation",
    "method": "POST",
    "path": "/hashtag/hashtag/continuation",
    "parameters": {
      "type": "object",
      "properties": {
        "hashtag": {
          "type": "string",
          "description": "hashtag"
        },
        "limit": {
          "type": "integer",
          "description": "limit"
        },
        "section": {
          "type": "string",
          "description": "section"
        },
        "language": {
          "type": "string",
          "description": "language"
        },
        "continuation_token": {
          "type": "string",
          "description": "continuation_token"
        }
      }
    }
  }
]

Example

curl -X GET 'https://api.agntdata.dev/v1/x/' \
  -H 'Authorization: Bearer $AGNTDATA_API_KEY'

Use Cases

  • Social and creator intelligence agents using X
  • Marketing and research teams monitoring accounts and content
  • Product teams building alerts, digests, and dashboards
  • Developers prototyping LLM tools that need live network data
  • Data teams joining X signals with CRM or warehouse data

Other Platforms

agntdata provides unified access to social data across multiple platforms. Explore other available APIs:

curl https://api.agntdata.dev/v1/platforms

Available platforms: LinkedIn, YouTube, TikTok, X, Instagram, Reddit, Facebook. Each uses the same API key and follows the same patterns.

Links

Usage Guidance
This skill appears to do exactly what it claims: call agntdata's X (Twitter) API using a single AGNTDATA_API_KEY. Before installing, verify you trust agntdata (https://api.agntdata.dev / https://app.agntdata.dev) because your API key will give that service access to requested social data. Do not include secrets or proprietary details in the activation "useCase" text. If you plan to install the optional plugin, review that plugin's npm package and permissions separately. Use least-privilege API keys when possible and rotate/delete keys you no longer need.
Capability Analysis
Type: OpenClaw Skill Name: agntdata-x Version: 1.0.13 The agntdata-x skill is a standard API integration for accessing X (Twitter) data via the agntdata.dev platform. It defines a comprehensive set of tools for social listening and data retrieval, requiring a user-provided API key (AGNTDATA_API_KEY) and the curl utility as specified in SKILL.md. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the code and instructions are consistent with the stated purpose of providing a unified social media data interface.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description say this is an agntdata wrapper for X/Twitter data; declared requirements (curl and AGNTDATA_API_KEY) and the SKILL.md endpoints all match that purpose and are expected for this integration.
Instruction Scope
SKILL.md confines actions to calling agntdata endpoints (discovery, register, and data endpoints). One minor privacy note: the activation/register call asks you to supply a free-form "useCase" string — avoid putting sensitive or proprietary info there, as it will be sent to api.agntdata.dev.
Install Mechanism
Instruction-only skill with no install spec or downloaded code; lowest-risk install profile. Optional plugin references point to an npm package but are clearly labeled optional.
Credentials
Only requests a single primary credential (AGNTDATA_API_KEY) which directly matches the declared API; no unrelated secrets or config paths are requested.
Persistence & Privilege
Does not request always: true, does not modify other skills or system configs, and runs only when invoked. No elevated persistence or cross-skill privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agntdata-x
  3. After installation, invoke the skill by name or use /agntdata-x
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.13
agntdata-x v1.0.13 - Version bump from 1.0.12 to 1.0.13 for maintenance and metadata update. - No new features or endpoint changes. - Documentation and metadata files updated.
v1.0.12
- Updated homepage link in the skill metadata to the latest agntdata X API documentation. - Bumped skill version from 1.0.11 to 1.0.12.
v1.0.11
agntdata-x 1.0.11 - Version bump from 1.0.10 to 1.0.11. - Documentation updated; no functional or API changes.
v1.0.10
agntdata-x 1.0.10 - Version bump to 1.0.10. - No functional changes; documentation and metadata update only.
v1.0.9
Version 1.0.9 - Updated to version 1.0.9 in SKILL.md. - API discovery endpoint documentation corrected: endpoint example now omits "credit costs" for accuracy. - No changes to the actual API endpoints or schemas; description and documentation clarified.
v1.0.7
agntdata-x 1.0.7 changelog: - Improved documentation for X (Twitter) API endpoints, capabilities, and setup. - Added detailed guidance for authentication and API key activation flows. - Listed all available endpoints and their JSON tool schema parameters. - Recommended using the OpenClaw plugin for best experience, but clarified skill use for plugin-incompatible environments.
Metadata
Slug agntdata-x
Version 1.0.13
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 6
Frequently Asked Questions

What is X (Twitter) API?

X (Twitter) API integration with a single agntdata API key (Bearer token). Read tweets, user profiles, followers, search, lists, trends, and hashtags. Use th... It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.

How do I install X (Twitter) API?

Run "/install agntdata-x" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is X (Twitter) API free?

Yes, X (Twitter) API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does X (Twitter) API support?

X (Twitter) API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created X (Twitter) API?

It is built and maintained by Jaen (@jaencarrodine); the current version is v1.0.13.

💬 Comments