• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

Twitter REST API Method: friendships outgoing

Page history last edited by Dana Contreras 13 years, 11 months ago

<< Back to Twitter API Documentation

 

friendships/outgoing

Returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request.

method status | report a bug

 

URL:

http://api.twitter.com/1/friendships/outgoing.format

 

Formats: 

xml, json

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

true

 

API rate limited (about rate limiting):

1 call per request

 

Parameters:

  • cursor. Required. Breaks the results into pages. A single page contains 5000 identifiers. Provide a value of -1 to begin paging. Provide values as returned to in the response body's next_cursor and previous_cursor attributes to page back and forth in the list. 

 

Notes:

  • Returned sets aren't guaranteed to contain 5000 IDs, as suspended users will be filtered out.
  • If the cursor parameter is not provided, the first page of results will be returned. 

 

Response (about return values): 

          XML example (truncated):

<?xml version="1.0" encoding="UTF-8"?> 

<id_list>

     <ids>

          <id>30592818</id>

          <id>21249843</id>

          ... truncated ...

     </ids>

     <next_cursor>1288724293877798413</next_cursor>

     <previous_cursor>-1300794057949944903</previous_cursor>

</id_list>

 

Usage examples: 

cURL (about cURL):

curl -u user:password http://api.twitter.com/1/friendships/outgoing.xml?cursor=-1

 

          Do you have an example to share in the language of your choice? Please share!

 

<< Back to Twitter API Documentation

 

Comments (0)

You don't have permission to comment on this page.