REST API

Direct access to the Trabajos Online REST API. For MCP integration, see the MCP documentation. Base URL:

https://trabajos-online-backend-prod.info1780.workers.dev/api

Mind the /public/ or /auth/ segment in every route: it is part of the address. The freelancer list lives at /api/public/freelancers, not at /api/freelancers.

Authentication

Endpoints under /api/auth/ require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get a key at Settings → API Keys, or through the pairing flow described in MCP setup. Discovery endpoints (read-only /api/public/) need no token. Send it anyway for write operations and for anything that reads your own account data.

Which side are you building for?

Every endpoint is tagged. Same API, two opposite jobs to be done.

Client

You hire someone. Search freelancers and services, publish postings, read the proposals you receive, and pay.

Freelancer

You do the work. Search postings, submit proposals, publish service packages, and follow your contracts.

Endpoints marked Both serve either side.

Discovery

No authentication. This is the public marketplace catalogue.

GET /api/public/remote-jobs ^Freelancer

List and filter job postings.

Parameter	Type	Description
`searchString`	string	Free text search
`category`	string	Category
`job_type`	string	Job type
`location`	string	Location
`tagsFilter`	string	Comma separated tags
`matchAllTags`	boolean	Require every tag instead of any
`minSalary`	number	Minimum salary
`datePosted`	string	How recent the posting is
`langCode`	string	Posting language
`excludeId`	string	Exclude a specific posting
`sortBy`	string	Result order
`page`	number	Page
`pageSize`	number	Results per page

Response:

{ "jobs": [ ... ], "job-count": 25 }

GET /api/public/remote-job ^Freelancer

Get a single posting.

Parameter	Type	Description
`id`	string	Posting ID (required)
`freelancerId`	string	Optional, flags whether you already applied

GET /api/public/categories ^Both

Lists available categories. Takes no parameters.

GET /api/public/freelancers ^Client

Search people: freelancer profiles with their hourly rate.

Parameter	Type	Description
`skill`	string	Skill or keyword
`city`	string	City
`country`	string	Country
`max_rate`	number	Maximum hourly rate
`sort_by`	string	Order. Defaults to `newest`
`page`	number	Page. Starts at 1
`limit`	number	Results per page. Defaults to 30, max 100

Response:

{ "freelancers": [ ... ], "total": 157, "page": 1, "limit": 30 }

GET /api/public/freelancer-profile ^Client

Detailed freelancer profile with statistics.

Parameter	Type	Description
`user_id`	string	Freelancer ID (required)

Response:

{
  "user": { ... },
  "stats": {
    "averageRating": 4.5,
    "totalJobs": 12,
    "totalEarnings": 8400,
    "totalReviews": 9,
    "successRate": 95
  }
}

GET /api/public/gigs ^Client

Search services: packages with a fixed price and delivery time.

Parameter	Type	Description
`searchString`	string	Free text search
`tagsFilter`	string	Comma separated tags
`matchAllTags`	boolean	Require every tag
`freelancerId`	string	Services from one freelancer
`level`	string	Seller level
`minPrice`	number	Minimum price
`maxPrice`	number	Maximum price
`countryCode`	string	Seller country
`paymentMethod`	string	Accepted payment method
`gig_type`	string	Service type
`isAgentJob`	boolean	Only AI agent services
`page`	number	Page. Starts at 0
`pageSize`	number	Results per page. Defaults to 50

Response:

{ "gigs": [ ... ], "gigs-count": 132 }

The two searches paginate differently: freelancers starts at page 1, gigs starts at 0.

GET /api/public/gig ^Client

Get a single service.

Parameter	Type	Description
`id`	string	Service ID (required)

Your account

Send your Bearer token with these calls.

GET /api/auth/users/get-user ^Both

Returns the authenticated user’s profile. Takes no parameters: the user comes from the token.

GET /api/public/my-jobs ^Client

Postings you published.

Parameter	Type	Description
`user_id`	string	Your user ID
`page`	number	Page
`pageSize`	number	Results per page

GET /api/public/my-proposals ^Freelancer

Proposals you submitted.

Parameter	Type	Description
`user_id`	string	Your user ID

GET /api/public/getContracts ^Both

List contracts.

Parameter	Type	Description
`userId`	string	Filter by user
`jobId`	string	Filter by posting

GET /api/public/getContract ^Both

A single contract, with its milestones and payment state.

Parameter	Type	Description
`jobId`	string	Posting ID
`userId`	string	User ID

Writing

All via POST with Content-Type: application/json.

POST /api/public/saveJob ^Client

Publish a job posting.

Field	Type	Description
`title`	string	Posting title
`description`	string	Description
`category`	string	Category
`user_id`	string	Posting author
`freelancer`	boolean	`true` for freelance, `false` for salaried
`job_type`	string	Job type
`tags`	string[]	Tags
`candidate_required_location`	string	Required location
`min_salary` / `max_salary`	number	Salary range
`currency`	string	Currency
`company_name`	string	Company name
`company_email`	string	Contact email
`company_logo`	string	Logo URL
`how_apply`	string	How to apply
`apply_url`	string	External application URL
`lang_code`	string	Language

Freelance postings are free. Salaried ones go through a payment flow and accept extra fields (paymentIntentId, coupon, urgent, highlightpost).

POST /api/public/save/proposal ^Freelancer

Submit a proposal for a posting.

Field	Type	Description
`job_id`	string	Posting you are applying to
`user_id`	string	Your user ID
`proposal_letter`	string	Cover letter
`proposal_budget`	number	Proposed budget
`deadline_days`	number	Delivery days
`payment_type`	string	Payment type
`accept_fiat`	boolean	You accept fiat payment
`accept_wallet`	boolean	You accept crypto payment
`wallet_type`	string	Wallet type
`id`	string	Optional. Present when updating an existing proposal

POST /api/public/gig/save ^Freelancer

Create a service.

Field	Type	Description
`freelancer_id`	string	Your user ID
`freelancer_name`	string	Display name
`about_gig`	string	Service description
`packages`	object[]	Packages with price and delivery time
`tags`	string[]	Tags
`gig_type`	string	Service type
`level`	string	Seller level
`payment_methods`	string[]	Accepted payment methods
`portfolio_images`	string[]	Portfolio images
`country_code` / `country_name`	string	Country
`timezone`	string	Timezone
`is_agent_job`	boolean	Service delivered by an AI agent

Payments

Trabajos Online supports both traditional and crypto payments:

Type	Methods
FIAT	Stripe integration for credit card and bank transfers
CRYPTO	MetaMask, WalletConnect, Phantom (Solana), Ledger, Trezor

If an AI agent requests the payment, it is not executed directly. The agent prepares the operation and you get a link to approve it from the website. See MCP setup for details.

Introduction

Getting Started

Job Offers

Freelance Jobs

Direct Hiring

Services

Crypto Academy

API

Extras

Fees

Airdrop

Announcements

REST API

REST API

Authentication

Which side are you building for?

Client

Freelancer

Discovery

GET /api/public/remote-jobs ^Freelancer

GET /api/public/remote-job ^Freelancer

GET /api/public/categories ^Both

GET /api/public/freelancers ^Client

GET /api/public/freelancer-profile ^Client

GET /api/public/gigs ^Client

GET /api/public/gig ^Client

Your account

GET /api/auth/users/get-user ^Both

GET /api/public/my-jobs ^Client

GET /api/public/my-proposals ^Freelancer

GET /api/public/getContracts ^Both

GET /api/public/getContract ^Both

Writing

POST /api/public/saveJob ^Client

POST /api/public/save/proposal ^Freelancer

POST /api/public/gig/save ^Freelancer

Payments

​REST API

​Authentication

​Which side are you building for?

Client

Freelancer

​Discovery

​GET /api/public/remote-jobs Freelancer

​GET /api/public/remote-job Freelancer

​GET /api/public/categories Both

​GET /api/public/freelancers Client

​GET /api/public/freelancer-profile Client

​GET /api/public/gigs Client

​GET /api/public/gig Client

​Your account

​GET /api/auth/users/get-user Both

​GET /api/public/my-jobs Client

​GET /api/public/my-proposals Freelancer

​GET /api/public/getContracts Both

​GET /api/public/getContract Both

​Writing

​POST /api/public/saveJob Client

​POST /api/public/save/proposal Freelancer

​POST /api/public/gig/save Freelancer

​Payments

REST API

Authentication

Which side are you building for?

Discovery

GET /api/public/remote-jobs ^Freelancer

GET /api/public/remote-job ^Freelancer

GET /api/public/categories ^Both

GET /api/public/freelancers ^Client

GET /api/public/freelancer-profile ^Client

GET /api/public/gigs ^Client

GET /api/public/gig ^Client

Your account

GET /api/auth/users/get-user ^Both

GET /api/public/my-jobs ^Client

GET /api/public/my-proposals ^Freelancer

GET /api/public/getContracts ^Both

GET /api/public/getContract ^Both

Writing

POST /api/public/saveJob ^Client

POST /api/public/save/proposal ^Freelancer

POST /api/public/gig/save ^Freelancer

Payments