Open projects from the Freelancehunt feed, newest first, 10 per page. Only skill_ids and employer_id are actually enforced by the API — only_my_skills and only_for_plus are documented but ignored by the server, so pass explicit skill ids to narrow the feed.

Walks several feed pages and filters them locally on criteria the API cannot express: keywords, budget floor, bid-count ceiling and employer quality. Use this to surface the few projects worth a bid instead of reading the whole feed.

Full details of one project, including the employer block and bid count.

Projects published by the authenticated account. Requires an employer profile — a freelancer-only account gets HTTP 400 from this endpoint.

Publishes a new project as an employer. Costs money or quota on the platform — confirm with the user before calling.

Edits a project that has not received bids yet. Once bids exist, use project_action with action amend instead — the API refuses plain edits at that point.

Employer-side lifecycle actions: amend adds an update to a project that already has bids, extend moves the expiry date, close stops accepting bids, reopen resumes.

Bids placed by the authenticated freelancer, including their status and winner flag.

Bids placed on one project — useful for sizing up the competition. The endpoint is documented but answers 404 for accounts that do not own the project.

Places a real bid on behalf of the token owner. Bids are a finite monthly resource and the employer sees them immediately, so confirm the amount, duration and comment with the user before calling. Note the API expects budget as an object — a flat amount is rejected.

revoke withdraws your own bid, restore puts it back, reject (employer) declines a freelancer's bid, choose (employer) picks the winner and starts the workspace. choose is effectively irreversible — always confirm with the user first.

The authenticated account: rating, per-skill ranking positions, Plus status, verification state and completed-project counters.

Public profile of one freelancer by id.

Public profile of one employer by id.

Reviews with their per-axis grades: communication, brief definition, payment and scope stability. For an employer these grades are the strongest available signal of how the project will actually go — check them before bidding.

Directory listing. Documented in the API but currently answers 404 for regular tokens — kept for completeness and in case access is restored.

Notifications for the authenticated account: bid replies, project updates, messages.

Clears the unread state of the activity feed.

Conversation threads of the authenticated account.

Messages inside one thread.

Posts a message into an existing thread, or opens a new thread with to_profile_id. Unsolicited messages to employers who never contacted you are spam under the platform rules and put the account at risk — only open a thread when the user asks for it.

mark_read clears the unread flag, delete removes the thread permanently, support opens a support request with the platform team.

Active project or contest workspaces of the authenticated account.

One workspace: agreed conditions, deadline and current state.

Drives the working agreement: propose_conditions / accept_conditions / reject_conditions negotiate price and deadline, extend moves the delivery date, complete / incomplete / close end the project, review leaves the closing review, request_arbitrage escalates a dispute to the platform. Closing and arbitration are irreversible and affect both ratings — always confirm with the user first.

Closes a contest workspace as completed.

The full skill catalogue with ids and groups. Skill ids are the only feed filter the API actually enforces, so start here before calling list_projects or find_projects. Names come back in the language set by FREELANCEHUNT_LANG.

Geography reference. Documented in the API but currently answers 404 for regular tokens — kept for completeness and in case access is restored.

Contest listings. Documented in the API but currently answers 404 for regular tokens — kept for completeness and in case access is restored.

One contest by id.

update edits a contest before publication, amend appends an update to a published one.