Skip to main content
GET
/
v1
/
scrape
/
twitter
/
search
Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/twitter/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "error": false,
    "cursor": {
      "bottom": "DAACCgACHC_nhDeAJxAKAAMcL-eEN3_Y8AgABAAAAAILAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNY0xKTVpCQnVSZVJ3cnBxOHZGN0NrSEM2bGtMWVhBWnNjTHcwR2JocmdlaHdsYXEvbG0xQnVIQjlJMUVlYXdkUWNKNjhCaXRyQkNod3JETnJjR2xFekhCRFRFRnNiRVMwY0txa3pSSnBRWXh2L0VBcW5tOURJSENwYlExVGF3TGtjTDVFK3h4dWhRUndzWDl1c0dsR3FIQnl5b1VuYkFkd2I5alY0alZiZ2h4d3U1ckxaRmhFVkhDVTI5Sk1ha1B3Y0p6VFhldHRoM1E9PQgABgAAAAAIAAcAAAAADAAICgABG_8QCqeb0MgAAAA",
      "top": "DAACCgACHC_nhDeAJxAKAAMcL-eEN3_Y8AgABAAAAAELAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNY0xKTVpCQnVSZVJ3cnBxOHZGN0NrSEM2bGtMWVhBWnNjTHcwR2JocmdlaHdsYXEvbG0xQnVIQjlJMUVlYXdkUWNKNjhCaXRyQkNod3JETnJjR2xFekhCRFRFRnNiRVMwY0txa3pSSnBRWXh2L0VBcW5tOURJSENwYlExVGF3TGtjTDVFK3h4dWhRUndzWDl1c0dsR3FIQnl5b1VuYkFkd2I5alY0alZiZ2h4d3U1ckxaRmhFVkhDVTI5Sk1ha1B3Y0p6VFhldHRoM1E9PQgABgAAAAAIAAcAAAAADAAICgABG_8QCqeb0MgAAAA"
    },
    "result": {
      "timeline": {
        "instructions": [
          {
            "entries": [
              {
                "content": {
                  "__typename": "TimelineTimelineModule",
                  "clientEventInfo": {
                    "component": "user_module",
                    "element": "module"
                  },
                  "displayType": "Carousel",
                  "entryType": "TimelineTimelineModule",
                  "footer": {
                    "displayType": "Classic",
                    "landingUrl": {
                      "url": "twitter://search?query=AI&src=typed_query&type=users",
                      "urlType": "DeepLink"
                    },
                    "text": "View all"
                  },
                  "header": {
                    "displayType": "Classic",
                    "sticky": true,
                    "text": "People"
                  },
                  "items": [
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-33838201",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjozMzgzODIwMQ==",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": false,
                                "can_media_tag": true,
                                "created_at": "Tue Apr 21 06:59:33 +0000 2009",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "Making AI helpful for everyone. Show thinking ↓",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "ai.google",
                                        "expanded_url": "https://ai.google",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/Bz9VfUNifq"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 1105,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 2354564,
                                "following": false,
                                "friends_count": 29,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 27645,
                                "location": "Mountain View, CA",
                                "media_count": 1350,
                                "muting": false,
                                "name": "Google AI",
                                "normal_followers_count": 2354564,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "2028873512203489483"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/33838201/1747684575",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1924554705503715328/0-HDhohz_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "GoogleAI",
                                "statuses_count": 3190,
                                "translator_type": "none",
                                "url": "https://t.co/Bz9VfUNifq",
                                "verified": false,
                                "verified_type": "Business",
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Square",
                              "rest_id": "33838201",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1622943797419155457",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNjIyOTQzNzk3NDE5MTU1NDU3",
                              "is_blue_verified": false,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Tue Feb 07 13:02:39 +0000 2023",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "$LAI is a Layer-2 blockchain that powers the AI economy.\n\n#AI2Earn\n\nChat: https://t.co/zRWRfEqnJi",
                                "entities": {
                                  "description": {
                                    "urls": [
                                      {
                                        "display_url": "t.me/LayerAI_org",
                                        "expanded_url": "http://t.me/LayerAI_org",
                                        "indices": [
                                          74,
                                          97
                                        ],
                                        "url": "https://t.co/zRWRfEqnJi"
                                      }
                                    ]
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "layerai.org",
                                        "expanded_url": "https://layerai.org/",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/5D5Ykqrfos"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 779,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 223195,
                                "following": false,
                                "friends_count": 29,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 424,
                                "location": "",
                                "media_count": 424,
                                "muting": false,
                                "name": "LayerAI | AI2Earn",
                                "normal_followers_count": 223195,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1940805182578676092"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1622943797419155457/1701374633",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1624905957846274055/TIN9IZEA_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "LayerAIorg",
                                "statuses_count": 732,
                                "translator_type": "none",
                                "url": "https://t.co/5D5Ykqrfos",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1622943797419155457",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1726913223885029376",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNzI2OTEzMjIzODg1MDI5Mzc2",
                              "is_blue_verified": false,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Tue Nov 21 10:39:58 +0000 2023",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "The most advanced AI upscaler & enhancer. Magnific can hallucinate and reimagine as many details as you wish (or none) guided by your own prompt and parameters!",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "magnific.ai",
                                        "expanded_url": "https://magnific.ai",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/tKQorD2P4D"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 1934,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 53840,
                                "following": false,
                                "friends_count": 4,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 675,
                                "location": "",
                                "media_count": 118,
                                "muting": false,
                                "name": "Magnific.ai",
                                "normal_followers_count": 53840,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1947706526929719416"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1726913223885029376/1700568182",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1726914935215529984/pNbqMvUP_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "Magnific_AI",
                                "statuses_count": 1303,
                                "translator_type": "none",
                                "url": "https://t.co/tKQorD2P4D",
                                "verified": false,
                                "verified_type": "Business",
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Square",
                              "rest_id": "1726913223885029376",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-175314969",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNzUzMTQ5Njk=",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": false,
                                "can_media_tag": false,
                                "created_at": "Fri Aug 06 07:40:50 +0000 2010",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "“We make war so that we may live in peace - Aristotle” Only for morons 😅 - \"Retweets and reposts are not endorsements\"",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 467,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 1012,
                                "following": false,
                                "friends_count": 125,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 1,
                                "location": "Siberia",
                                "media_count": 64,
                                "muting": false,
                                "name": "ai",
                                "normal_followers_count": 1012,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "2029224870081335382"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/175314969/1640726559",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/2029031615159255043/8dnSgjf__normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": true,
                                "screen_name": "CamelotOfAfrica",
                                "statuses_count": 762,
                                "translator_type": "none",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "professional": {
                                "category": [
                                  {
                                    "icon_name": "",
                                    "id": 1049,
                                    "name": "Data scientist"
                                  }
                                ],
                                "professional_type": "Creator",
                                "rest_id": "1468430062555115521"
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "175314969",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {
                                "is_enabled": true
                              }
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1315312160382291968",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxMzE1MzEyMTYwMzgyMjkxOTY4",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Sun Oct 11 15:24:04 +0000 2020",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "my spicy page is only $3 rn 🌶️ ;) backup: @airikaca",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "onlyfans.com/airikacal/c5",
                                        "expanded_url": "http://onlyfans.com/airikacal/c5",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/S6KwwyFuu0"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 320,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 655893,
                                "following": false,
                                "friends_count": 26,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 655,
                                "location": "LA",
                                "media_count": 45,
                                "muting": false,
                                "name": "airikacal",
                                "normal_followers_count": 655893,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1896164392703873374"
                                ],
                                "possibly_sensitive": false,
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1963986432487292928/JmI19fYi_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "airikacal",
                                "statuses_count": 46,
                                "translator_type": "none",
                                "url": "https://t.co/S6KwwyFuu0",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "professional": {
                                "category": [
                                  {
                                    "icon_name": "",
                                    "id": 934,
                                    "name": "Social Media Influencer"
                                  }
                                ],
                                "professional_type": "Business",
                                "rest_id": "1604249592354127872"
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1315312160382291968",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1157283331509235713",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxMTU3MjgzMzMxNTA5MjM1NzEz",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Fri Aug 02 13:33:42 +0000 2019",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "The AI omnicloud PyTorch developers love. Made the first AI Studio & PyTorch Lightning. Get help: https://t.co/a69wnEBpKH",
                                "entities": {
                                  "description": {
                                    "urls": [
                                      {
                                        "display_url": "discord.com/invite/MWAEvnC…",
                                        "expanded_url": "https://discord.com/invite/MWAEvnC5fU",
                                        "indices": [
                                          98,
                                          121
                                        ],
                                        "url": "https://t.co/a69wnEBpKH"
                                      }
                                    ]
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "lightning.ai",
                                        "expanded_url": "http://lightning.ai",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/hXSE3ZhzKN"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 3642,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 46421,
                                "following": false,
                                "friends_count": 89,
                                "has_custom_timelines": true,
                                "is_translator": false,
                                "listed_count": 1128,
                                "location": "New York, NY",
                                "media_count": 1401,
                                "muting": false,
                                "name": "Lightning AI ⚡️",
                                "normal_followers_count": 46421,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1885783429238894630"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1157283331509235713/1759422406",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1734973544985919489/1ni2KrpZ_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "LightningAI",
                                "statuses_count": 4781,
                                "translator_type": "none",
                                "url": "https://t.co/hXSE3ZhzKN",
                                "verified": false,
                                "verified_type": "Business",
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "professional": {
                                "category": [
                                  {
                                    "icon_name": "",
                                    "id": 713,
                                    "name": "Science & Technology"
                                  }
                                ],
                                "professional_type": "Business",
                                "rest_id": "1561731328961155072"
                              },
                              "profile_image_shape": "Square",
                              "rest_id": "1157283331509235713",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1455697568499781633",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNDU1Njk3NTY4NDk5NzgxNjMz",
                              "is_blue_verified": false,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Wed Nov 03 00:45:36 +0000 2021",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "$MTOS | No.4 Dapp & No.1 Game on Solana\nLeading Global Kiwi #MEME Culture 🥝\nAI Agents with Crypto Wallets & Humans Building Future Game\nSince 2021\n#AIGaming",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "link3.to/metaoasis",
                                        "expanded_url": "http://link3.to/metaoasis",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/0NqqjyB5H2"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 1167,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 457125,
                                "following": false,
                                "friends_count": 186,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 193,
                                "location": "Formerly MetaOasis",
                                "media_count": 540,
                                "muting": false,
                                "name": "MomoAI☮️🥝",
                                "normal_followers_count": 457125,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1874044001005060508"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1455697568499781633/1735358048",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1873567408830771200/pRsrIs36_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "Metaoasis_",
                                "statuses_count": 1118,
                                "translator_type": "none",
                                "url": "https://t.co/0NqqjyB5H2",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1455697568499781633",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1753744475464052736",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNzUzNzQ0NDc1NDY0MDUyNzM2",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": true,
                                "can_media_tag": true,
                                "created_at": "Sat Feb 03 11:37:33 +0000 2024",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "Largest AI infra on SUI/BSC/BTC. Deploy autonomous AI Agents with identity, continuity & consensus. Make AI smarter.",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "link3.to/deagentai",
                                        "expanded_url": "https://link3.to/deagentai",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/DVNDAkk5PS"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 6788,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 280812,
                                "following": false,
                                "friends_count": 126,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 143,
                                "location": "DA's Home 👉",
                                "media_count": 304,
                                "muting": false,
                                "name": "DeAgentAI",
                                "normal_followers_count": 280812,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "2030486052394480118"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1753744475464052736/1745896115",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/2007338834913267712/-X2NX6w5_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "DeAgentAI",
                                "statuses_count": 1764,
                                "translator_type": "none",
                                "url": "https://t.co/DVNDAkk5PS",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "professional": {
                                "category": [
                                  {
                                    "icon_name": "",
                                    "id": 713,
                                    "name": "Science & Technology"
                                  }
                                ],
                                "professional_type": "Business",
                                "rest_id": "1843934150866415638"
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1753744475464052736",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1831598136",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {},
                              "has_graduated_access": true,
                              "id": "VXNlcjoxODMxNTk4MTM2",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": false,
                                "can_media_tag": true,
                                "created_at": "Sun Sep 08 16:48:56 +0000 2013",
                                "default_profile": false,
                                "default_profile_image": false,
                                "description": "Aussie single mama living in the woods 🌲",
                                "entities": {
                                  "description": {
                                    "urls": []
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "onlyfans.com/vickyaisha/tri…",
                                        "expanded_url": "https://onlyfans.com/vickyaisha/trial/90v0iidh1f2nyfbh9kr0jizqxjge6qeg",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/RSUTFPOZ1r"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 1694,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 1160468,
                                "following": false,
                                "friends_count": 69,
                                "has_custom_timelines": true,
                                "is_translator": false,
                                "listed_count": 1324,
                                "location": "It’s FREE 👉🏼",
                                "media_count": 565,
                                "muting": false,
                                "name": "Vicky Aisha 🤠",
                                "normal_followers_count": 1160468,
                                "notifications": false,
                                "pinned_tweet_ids_str": [
                                  "1977377148701696208"
                                ],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1831598136/1761433254",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1969400164545937413/sB4AQcaS_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "Vicky_Aisha_",
                                "statuses_count": 1304,
                                "translator_type": "none",
                                "url": "https://t.co/RSUTFPOZ1r",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1831598136",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    },
                    {
                      "entryId": "toptabsrpusermodule-2031096512020217856-user-1621579092775604225",
                      "item": {
                        "clientEventInfo": {
                          "component": "user_module",
                          "details": {
                            "timelinesDetails": {
                              "controllerData": "DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA="
                            }
                          },
                          "element": "user"
                        },
                        "itemContent": {
                          "__typename": "TimelineUser",
                          "itemType": "TimelineUser",
                          "userDisplayType": "UserDetailed",
                          "user_results": {
                            "result": {
                              "__typename": "User",
                              "affiliates_highlighted_label": {
                                "label": {
                                  "badge": {
                                    "url": "https://pbs.twimg.com/profile_images/1372643278378663940/fV2U3iEi_bigger.jpg"
                                  },
                                  "description": "UwU Market",
                                  "url": {
                                    "url": "https://twitter.com/shopuwumarket",
                                    "urlType": "DeepLink"
                                  },
                                  "userLabelDisplayType": "Badge",
                                  "userLabelType": "BusinessLabel"
                                }
                              },
                              "has_graduated_access": true,
                              "id": "VXNlcjoxNjIxNTc5MDkyNzc1NjA0MjI1",
                              "is_blue_verified": true,
                              "legacy": {
                                "blocked_by": false,
                                "blocking": false,
                                "can_dm": false,
                                "can_media_tag": true,
                                "created_at": "Fri Feb 03 18:39:23 +0000 2023",
                                "default_profile": true,
                                "default_profile_image": false,
                                "description": "AI VTuber at https://t.co/BZQBABqZVP | Fan art #Heartheartart\nCreated by @Vedal987 | Model art @annytf | All tweets made by Neuro-sama",
                                "entities": {
                                  "description": {
                                    "urls": [
                                      {
                                        "display_url": "twitch.tv/vedal987",
                                        "expanded_url": "http://twitch.tv/vedal987",
                                        "indices": [
                                          13,
                                          36
                                        ],
                                        "url": "https://t.co/BZQBABqZVP"
                                      }
                                    ]
                                  },
                                  "url": {
                                    "urls": [
                                      {
                                        "display_url": "vedal.ai",
                                        "expanded_url": "https://vedal.ai/",
                                        "indices": [
                                          0,
                                          23
                                        ],
                                        "url": "https://t.co/UND0IvwPX5"
                                      }
                                    ]
                                  }
                                },
                                "fast_followers_count": 0,
                                "favourites_count": 0,
                                "follow_request_sent": false,
                                "followed_by": false,
                                "followers_count": 247164,
                                "following": false,
                                "friends_count": 2,
                                "has_custom_timelines": false,
                                "is_translator": false,
                                "listed_count": 352,
                                "location": "@Vedal987's Computer",
                                "media_count": 24,
                                "muting": false,
                                "name": "Neuro-sama 💜",
                                "normal_followers_count": 247164,
                                "notifications": false,
                                "pinned_tweet_ids_str": [],
                                "possibly_sensitive": false,
                                "profile_banner_url": "https://pbs.twimg.com/profile_banners/1621579092775604225/1746299075",
                                "profile_image_url_https": "https://pbs.twimg.com/profile_images/1918744443168886784/F9P2MtSE_normal.jpg",
                                "profile_interstitial_type": "",
                                "protected": false,
                                "screen_name": "NeurosamaAI",
                                "statuses_count": 445,
                                "translator_type": "none",
                                "url": "https://t.co/UND0IvwPX5",
                                "verified": false,
                                "want_retweets": false,
                                "withheld_in_countries": []
                              },
                              "profile_image_shape": "Circle",
                              "rest_id": "1621579092775604225",
                              "super_follow_eligible": false,
                              "super_followed_by": false,
                              "super_following": false,
                              "tipjar_settings": {}
                            }
                          }
                        }
                      }
                    }
                  ]
                },
                "entryId": "toptabsrpusermodule-2031096512020217856",
                "sortIndex": "2031096512020217856"
              }
            ],
            "type": "TimelineAddEntries"
          }
        ],
        "responseObjects": {
          "feedbackActions": [
            {
              "key": "-2134788070",
              "value": {
                "childKeys": [
                  "269351462",
                  "-1399782652"
                ],
                "clientEventInfo": {
                  "action": "click",
                  "component": "result",
                  "element": "feedback_givefeedback"
                },
                "confirmation": "Thanks for offering your feedback. X is conducting research to improve search. Choose the option that best reflects your opinion.",
                "confirmationDisplayType": "Inline",
                "feedbackType": "GiveFeedback",
                "hasUndoAction": true,
                "icon": "Frown",
                "prompt": "This post's not helpful"
              }
            },
            {
              "key": "269351462",
              "value": {
                "clientEventInfo": {
                  "action": "click",
                  "component": "result",
                  "element": "feedback_notrelevant"
                },
                "confirmation": "Thanks for your help.\nThis feedback will be used in research to improve the search function.",
                "confirmationDisplayType": "Inline",
                "feedbackType": "NotRelevant",
                "hasUndoAction": true,
                "prompt": "This post isn't relevant"
              }
            },
            {
              "key": "-1399782652",
              "value": {
                "clientEventInfo": {
                  "action": "click",
                  "component": "result",
                  "element": "feedback_notcredible"
                },
                "confirmation": "Thanks for your help.\nThis feedback will be used in research to improve the search function.",
                "confirmationDisplayType": "Inline",
                "feedbackType": "NotCredible",
                "hasUndoAction": true,
                "prompt": "This post isn't credible"
              }
            }
          ]
        }
      }
    }
  },
  "credits_used": 1,
  "endpoint": "twitter/search"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

The search query text

Example:

"AI"

​
type
enum<string>
default:Top

The type of search results to return. Defaults to Top if not provided.

Available options:
Top,
Latest,
People,
Photos,
Media,
Lists
Example:

"Top"

​
cursor
string

Pagination cursor from a previous response to get the next page of results

Response

Successful response

Key Response Fields:

Pagination:

  • data.cursor.bottom: Pass as cursor query param to get the next page of results
  • data.cursor.top: Cursor for the previous/newer page

Search Results (type=Top):

  • data.result.timeline.instructions[0].entries[]: Array of result entries (type TimelineAddEntries)

People Carousel (first entry when type=Top):

  • entries[0].content.items[]: Array of matched user profiles displayed in a carousel
  • entries[0].content.header.text: Will be People
  • Each user at .item.itemContent.user_results.result:
    • .rest_id: User's numeric ID
    • .is_blue_verified: Blue checkmark status
    • .legacy.name: Display name
    • .legacy.screen_name: Handle (username without @)
    • .legacy.description: Bio
    • .legacy.followers_count: Follower count
    • .legacy.friends_count: Following count
    • .legacy.profile_image_url_https: Profile picture URL
    • .legacy.verified_type: Business for business accounts

Tweet Results (subsequent entries):

  • Each tweet at entries[].content.itemContent.tweet_results.result:
    • .rest_id: Tweet ID
    • .legacy.full_text: Tweet text
    • .legacy.created_at: Timestamp
    • .views.count: View count (string)
    • .legacy.favorite_count: Likes
    • .legacy.retweet_count: Retweets
    • .legacy.reply_count: Replies
    • .legacy.quote_count: Quote tweets
    • .legacy.bookmark_count: Bookmarks

Feedback Actions:

  • data.result.timeline.responseObjects.feedbackActions[]: Internal feedback metadata (can ignore)