Group
Get an X community.
GET | POST /v1/x/groupSend parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.
What to Pass
| Pass | Reads | Notes |
|---|---|---|
community | The community | A numeric id or URL |
Pass one source per call. Every identifier also takes the page URL.
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
community | string | Numeric community id, or the community URL (x.com/i/communities/<id>). |
Request
curl "https://gateway.apinoa.com/v1/x/group?community=1601841656147345410" \
-H "x-api-key: $APINOA_API_KEY"Response
Returns Group in data. A real response, shortened: arrays keep their first entries and long text is cut.
{
"success": true,
"data": {
"platform": "x",
"kind": "community",
"id": "1601841656147345410",
"name": "Generative AI",
"url": "https://x.com/i/communities/1601841656147345410",
"description": "Share AI-generated creations, news, tips and more."
}
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAMS | A parameter is missing, unknown or out of range. The message names it. |
| 401 | UNAUTHORIZED | The x-api-key header is missing, or the key is revoked or unknown. |
| 402 | INSUFFICIENT_BALANCE | The balance does not cover this call. Top up in the dashboard. |
| 404 | NOT_FOUND | The account, post or group does not exist, or is private, deleted or age-restricted. |
| 429 | MARKETPLACE_SATURATED | Too many concurrent calls. Retry after the Retry-After seconds. |
| 502 | UPSTREAM_ERROR | The platform answered with something unusable. Retry with backoff. |
Every code is listed in Errors. Failed calls are not billed.
Pricing
Price $0.001 per call. List price; the rate steps down above 1,000 calls a day.