{"id":37003483,"url":"https://github.com/notfoundsam/yahoo-auction","last_synced_at":"2026-01-14T00:33:39.901Z","repository":{"id":47206360,"uuid":"83438395","full_name":"notfoundsam/yahoo-auction","owner":"notfoundsam","description":"Php library for yahoo auction. Bid on lot, watch bidding lots and get won lots","archived":false,"fork":false,"pushed_at":"2024-11-30T12:58:47.000Z","size":554,"stargazers_count":17,"open_issues_count":2,"forks_count":8,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-08-11T21:19:46.725Z","etag":null,"topics":["auction","bidding","php","yahoo","yahoo-auction"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/notfoundsam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-28T13:56:27.000Z","updated_at":"2025-06-05T19:20:35.000Z","dependencies_parsed_at":"2024-12-01T16:45:32.920Z","dependency_job_id":null,"html_url":"https://github.com/notfoundsam/yahoo-auction","commit_stats":{"total_commits":38,"total_committers":2,"mean_commits":19.0,"dds":0.02631578947368418,"last_synced_commit":"28ad91ee7dd3ed4b516f42988548c81b8cae8c98"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/notfoundsam/yahoo-auction","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notfoundsam%2Fyahoo-auction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notfoundsam%2Fyahoo-auction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notfoundsam%2Fyahoo-auction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notfoundsam%2Fyahoo-auction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/notfoundsam","download_url":"https://codeload.github.com/notfoundsam/yahoo-auction/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/notfoundsam%2Fyahoo-auction/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28406510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T21:51:37.118Z","status":"ssl_error","status_checked_at":"2026-01-13T21:45:14.585Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["auction","bidding","php","yahoo","yahoo-auction"],"created_at":"2026-01-14T00:33:39.279Z","updated_at":"2026-01-14T00:33:39.863Z","avatar_url":"https://github.com/notfoundsam.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yahoo Auction Http library\n\n### Description\nThis library will help you to work with Yahoo auction. It makes requests to Yahoo auction like a normal browser. To use this library you must specify your username and password from Yahoo to login. In order not to make a login every time, after the first login, save your cookies so that the following requests will be in the same session. You can view your won lots and bidding lots. To get information about the lot or bid on the lot, you will need an application key.\n\n### Requirements\n- php \u003e= 5.4\n- php-curl\n- php-mbstring\n- php-xml\n\n### Installation\n```\ncomposer require notfoundsam/yahoo-auction\n```\n\n### Examples\nSpecify your credentials and create a new instance of Browser object.\n```\nrequire __DIR__ . '/../vendor/autoload.php';\n\nuse Yahooauc\\Browser as Browser;\n\n$userName = \"your_yahoo_user\";\n$userPass = \"your_yahoo_pass\";\n\n/* Get saved cookie */\n$cookie = file_get_contents('cookie.cache');\n$cookieJar = $cookie !== false ? unserialize($cookie) : [];\n\n$browser = new Browser($userName, $userPass, null, $cookieJar);\n```\nIf you don't have cookies yet try to login into Yahoo. \nIt throws `LoginException` or `CaptchaException` if something wrong.\n```\n/* Try to login into Yahoo */\nvar_dump($browser-\u003elogin());\n```\nIf you already have cookies try to check it.\n```\n/* Check is logged in */\nvar_dump($browser-\u003echeckLogin());\n```\nUse the next methods to get information about your auctions or bid on the lot.\n```\n/* Get information about the lot */\nvar_dump($browser-\u003egetAuctionInfoAsXml(\"auction_lot_id\"));\n\n/* Get list of lots from the first bidding page */\nvar_dump($browser-\u003egetBiddingLots(1));\n\n/* Get array of auction id from the first won page */\nvar_dump($browser-\u003egetWonIds(1));\n\n/* Bid on the lot. The second argument is price in yen */\nvar_dump($browser-\u003ebid(\"auction_lot_id\", 100));\n```\nIn the end save your browser cookies to use it next time.\n```\n$cookieJar = $browser-\u003egetCookie();\n$cookie = serialize($cookieJar);\nfile_put_contents('cookie.cache', $cookie);\n```\n\n### Debug\nSince v1.1.0 you can use the debugging mode to test your application locally. Export `YAHOO_AUC_ENV` to your environment. Set it to `production` to use on production or other to use the debugging mode.\n```\nexport YAHOO_AUC_ENV=local\n```\nYou can also enable or disable the debugging mode with the following method.  \nPass the second argument with the path to the folder with your test files.\n```\n$browser-\u003edebug($debug = true);\n$browser-\u003edebug($debug = true, $testPath = 'your_folder_with_test_pages');\n```\n### How to use the debugging mode\nReplace `test_user` with something else to throw `LoginException`. It means the login failed.\n```\n$userName = \"not_test_user\";\n$userPass = \"secret_password\";\n\n$browser = new Browser($userName, $userPass, null, []);\n$browser-\u003edebug($debug = true);\n```  \nPass the following id `n000000000` to throw `PageNotfoundException`. It means the auction not found.\n```\n$userName = \"test_user\";\n$userPass = \"secret_password\";\n\n$browser = new Browser($userName, $userPass, null, []);\n$browser-\u003edebug($debug = true);\n$browser-\u003egetAuctionInfoAsXml(\"n000000000\");\n```\nGet an array of fake data from the first bidding page.\n```\n$userName = \"test_user\";\n$userPass = \"secret_password\";\n\n$browser = new Browser($userName, $userPass, null, []);\n$browser-\u003edebug($debug = true);\n$browser-\u003egetBiddingLots(1);\n```\nGet an array of fake IDs from the first won page.\n```\n$userName = \"test_user\";\n$userPass = \"secret_password\";\n\n$browser = new Browser($userName, $userPass, null, []);\n$browser-\u003edebug($debug = true);\n$browser-\u003egetWonIds(1);\n```\nBid on the following lot `e000000000` to throw `AuctionEndedException`. This auction has already ended.  \nBid on the following lot `x000000000` with price under `220` to throw `BrowserException`. It means your price is lower than the current price.  \nBid on the following lot `x000000000` with price between `220` and `999` to throw `RebidException`. It means the price of the lot has rose, and the bid failed.  \nBid on the following lot `x000000000` with price more than `999` for a successful bid.\n```\n$userName = \"test_user\";\n$userPass = \"secret_password\";\n\n$browser = new Browser($userName, $userPass, null, []);\n$browser-\u003edebug($debug = true);\n$browser-\u003ebid(\"e000000000\", 1000); // Has already ended\n$browser-\u003ebid(\"x000000000\", 100);  // Not enough\n$browser-\u003ebid(\"x000000000\", 500);  // Rebid page, bid failed\n$browser-\u003ebid(\"x000000000\", 1000); // Success\n```\n\n## About v1.3.x\n\n### Features\n- Added xdebug to the docker container.\n\n### Updates\n- Yahoo auction API was removed because Yahoo fully closed their API.\n- If the page or lot not found it will throw `PageNotfoundException`.\n- Check login with new request (Sometimes after login Yahoo shows different page).\n- Remove unnecessary request options in `Browser` constructor.\n\n### Fixes\n- The method `getAuctionImgsUrl` returned empty array.\n\n### Notes\n- Field `$appId` don't need anymore, pass null instead to the `Browser` constructor.\n- Method `$browser-\u003egetAuctionInfoAsXml(\"...\")` returns shorted version of API result. Currently, available fields: `AuctionID`, `AuctionItemUrl`, `Title`, `Seller-\u003eId`, `Img`, `Price`, `TaxinPrice`, `StartTime`, `EndTime`, `Status`.\n\n### Migration from v1.2.x\n- Check available fields for `$browser-\u003egetAuctionInfoAsXml(\"...\")` in Notes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotfoundsam%2Fyahoo-auction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnotfoundsam%2Fyahoo-auction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnotfoundsam%2Fyahoo-auction/lists"}