get/search/geo

Geo Search (Beta)

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access X data through agntdata: Geo Search (Beta). Perform Geo search. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need tweets, user profiles, followers, search, and hashtag streams programmatically.

Use cases

AI agents that need X data in structured form

Analytics and monitoring pipelines for X content

Research and GTM workflows that combine X signals with other data

Parameters

Name	In	Type	Required	Description
section	query	string	optional	—Default: `top`
language	query	string	optional	—Default: `en`
limit	query	string	optional	—Default: `50`
query	query	string	required	—Default: `paris`
range	query	string	optional	—Default: `2`
longitude	query	string	optional	—Default: `2.294694`
latitude	query	string	optional	—Default: `48.858093`

Responses

Successful response

{
  "type": "object"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Geo_Search___Beta__get__search_geo",
  "method": "get",
  "path": "/search/geo",
  "summary": "Geo Search  (Beta)",
  "description": "Perform Geo search",
  "parameters": [
    {
      "name": "section",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "top"
      }
    },
    {
      "name": "language",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "en"
      }
    },
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "50"
      }
    },
    {
      "name": "query",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "paris"
      }
    },
    {
      "name": "range",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "2"
      }
    },
    {
      "name": "longitude",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "2.294694"
      }
    },
    {
      "name": "latitude",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "default": "48.858093"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Bad request"
    },
    {
      "statusCode": "401",
      "description": "Unauthorized - invalid API key"
    },
    {
      "statusCode": "429",
      "description": "Rate limit exceeded"
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Start for free

Related endpoints

getLists Tweets

/lists/tweets

getLists Details

/lists/details

getSearch

/search/search

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Get started for free View all endpoints

X APIX data APIgeo search (beta) APIAI agents data APIX APIX data APIX for AI agents

Back to X (Twitter)