tarekbadrshalaan / twfinder

Find keyword in Twitter User followers/following

twfinder

Find twitter users by (name, handle, bio, location, followers, following count or verified).

By using Twitter API, The application starts with one user and finds in his (followers/following) any account that matches the search criteria and continues recursively with the matched users.

How does it work

1. By using Twitter-API endpoints

   • tw-api/followers/ids.json
   • tw-api/friends/ids.json

   And collect the metadata for twitter users

2. Apply the search criteria on the coming users.

   • Any sub-route under configuration SEARCH_CRITERIA will consider as an and condition
   • Any option in the sub-routes use or condition

Examples SEARCH_CRITERIA Configuration

• All Users in Berlin have in them bio (Developer, Software or Engineer)

    "SEARCH_CRITERIA": {
        "SEARCH_BIO_CONTEXT": [
            "Developer",
            "Software",
            "Engineer"
        ],
        "SEARCH_LOCATION_CONTEXT": [
            "Berlin"
        ]
    }

• All Users in Silicon Valley have in them bio (CEO or CTO) and have a verified account

    "SEARCH_CRITERIA": {
        "SEARCH_BIO_CONTEXT": [
            "CEO",
            "CTO"
        ],
        "SEARCH_LOCATION_CONTEXT": [
            "Silicon Valley"
        ],
        "VERIFIED": true
    }

• All Users have in them NAME (dr) and have more then 1000000 FOLLOWERS

    "SEARCH_CRITERIA": {
        "SEARCH_NAME_CONTEXT": [
            "dr"
        ],
        "FOLLOWERS_COUNT_BETWEEN": {
            "FROM": 1000000
        }
    }

How To Use

Windows Users

1. Use the prebuilt binary in for Windows Users, Download the binary from
2. Use the configuration file to configure the app (download from ) Update it with your twitter credentials in config.json
3. Update the SEARCH_CRITERIA in with your search criteria.
4. run the application
5. the result will be in result directory

Ubuntu Users

1. Use the prebuilt binary in for Ubuntu Users, Download the binary from
2. Use the configuration file to configure the app (download from ) Update it with your twitter credentials in config.json
3. Update the SEARCH_CRITERIA in with your search criteria.
4. run the application
5. the result will be in result directory

Build From Source

twfinder build in golang, compile it with golang 13.0 or later

1. Build the application by run go build .
2. Update the configuration file with your twitter credentials
3. Update the SEARCH_CRITERIA in with your search criteria.
4. run the application
5. the result will be in result directory