{"id":26804831,"url":"https://github.com/throughnothing/webservice-pocket","last_synced_at":"2025-08-02T15:09:21.082Z","repository":{"id":3570395,"uuid":"4632642","full_name":"throughnothing/WebService-Pocket","owner":"throughnothing","description":"Client for the Pocket api (http://getpocket.com/api/)","archived":false,"fork":false,"pushed_at":"2013-11-13T19:32:25.000Z","size":149,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-23T06:33:29.838Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://metacpan.org/release/WebService-Pocket/","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/throughnothing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-06-12T03:00:40.000Z","updated_at":"2015-04-29T06:25:12.000Z","dependencies_parsed_at":"2022-08-02T10:35:20.219Z","dependency_job_id":null,"html_url":"https://github.com/throughnothing/WebService-Pocket","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/throughnothing/WebService-Pocket","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2FWebService-Pocket","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2FWebService-Pocket/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2FWebService-Pocket/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2FWebService-Pocket/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/throughnothing","download_url":"https://codeload.github.com/throughnothing/WebService-Pocket/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/throughnothing%2FWebService-Pocket/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268408197,"owners_count":24245577,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-29T22:27:15.348Z","updated_at":"2025-08-02T15:09:21.052Z","avatar_url":"https://github.com/throughnothing.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nWebService::Pocket - Client for the Pocket api (http://getpocket.com/api/)\n\n# VERSION\n\nversion 0.003\n\n# SYNOPSIS\n\n    use WebService::Pocket;\n\n    my $p = WebService::Pocket-\u003enew(\n        username =\u003e 'throughnothing',\n        password =\u003e 'secret',\n    );\n\n    # Get list of read items as Array of WebService::Pocket::Item objects\n    my $items = $p-\u003elist( state =\u003e 'read' );\n\n    # Add an item\n    $p-\u003eadd({ url =\u003e 'http://www.article.com', title =\u003e 'My Title' });\n\n    # Add multiple items, returns Array of WebService::Pocket::Item objects\n    my $new_items = $p-\u003eadd([\n        { url =\u003e 'http://www.article.com' },\n        { url =\u003e 'http://www.article1.com', title =\u003e 'Article1' },\n        { url =\u003e 'http://www.article2.com', title =\u003e 'Best Article' },\n    ]);\n\n    # Get Titles and URL's for new items\n    for ( @$new_items ) {\n        say $_-\u003etitle . \" : \" . $_-\u003eurl;\n    }\n\n    # Update read status of an item\n    $items-\u003e[0]-\u003estate( 0 );\n\n    # Update title of an item\n    $items-\u003e[0]-\u003etitle( 'New Title' );\n\n    # Update tags of an item ( replaces all tags with these )\n    $items-\u003e[0]-\u003etags( [ 'tag1', 'tag2', 'tag3' ] );\n\n# DESCRIPTION\n\nThis distribution provides an easy interface to the\n[Pocket API](http://getpocket.com/api/).  It allows you to add, view and modify\nyour list of items in a very simple way.\n\n# METHODS\n\n## new\n\nThe constructor accepts a `username` and `password` and validates\nyour credentials with the [Pocket API](http://getpocket.com/api/):\n\n    my $p = WebService::Pocket-\u003enew(\n        username =\u003e 'throughnothing',\n        password =\u003e 'myS3cr3t',\n    );\n\n## add\n\nAllows you to add items to your `Pocket` list.  You can add a single item\nvia a simple HashRef:\n\n    my ( $new_item ) = $p-\u003eadd( { url =\u003e 'http://youtube.com/video' } );\n\nOr multiple items via an ArrayRef:\n\n    my $new_items = $p-\u003eadd([\n        { url =\u003e 'http://youtube.com/video', title =\u003e 'video 1' },\n        { url =\u003e 'http://youtube.com/video2', title =\u003e 'video 2' },\n    ]);\n\nNote that only the `url` field is required for each added item, but you\ncan set the `title` as well if you like. The `add` function will always\nreturn an ArrayRef of [WebService::Pocket::Item](https://metacpan.org/pod/WebService::Pocket::Item) objects if it succeeded.\n\n## list\n\nAllows you to retrieve the list of items in your `Pocket` account.  Returns\na list of [WebService::Pocket::Item](https://metacpan.org/pod/WebService::Pocket::Item) objects.\n\n    my $items = $p-\u003elist;\n\nYou can pass in any parameters available to the\n[Pocket API Get](http://getpocket.com/api/docs/#get) request.\n\n    # Get only read items, with tags\n    $p-\u003elist( state = 0, tags =\u003e 1 );\n\n    # Get only the first 5 resutls\n    $p-\u003elist( count =\u003e 5, page =\u003e 1 );\n\n## stats\n\nStats will return a [WebService::Pocket::Stats](https://metacpan.org/pod/WebService::Pocket::Stats) object, which contains\na few statistics about your `Pocket` account.\n\n    # Get the stats object\n    my $stats = $p-\u003estats;\n\n    # How long i've been a user\n    say $stats-\u003euser_since;\n\n    # How many items in my list total\n    say $stats-\u003ecount_list;\n\n    # How many unread items in my list\n    say $stats-\u003ecount_unread;\n\n    # How many read items in my list\n    say $stats-\u003ecount_read;\n\n# AUTHOR\n\nWilliam Wolf \u003cthroughnothing@gmail.com\u003e\n\n# COPYRIGHT AND LICENSE\n\n\n\nWilliam Wolf has dedicated the work to the Commons by waiving all of his\nor her rights to the work worldwide under copyright law and all related or\nneighboring legal rights he or she had in the work, to the extent allowable by\nlaw.\n\nWorks under CC0 do not require attribution. When citing the work, you should\nnot imply endorsement by the author.\n\n# CONTRIBUTORS\n\n- Andreas Marienborg \u003candreas.marienborg@gmail.com\u003e\n- Paul Fenwick \u003cpjf@perltraining.com.au\u003e\n- ben hengst \u003cnotbenh@cpan.org\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthroughnothing%2Fwebservice-pocket","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthroughnothing%2Fwebservice-pocket","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthroughnothing%2Fwebservice-pocket/lists"}