Public REST/JSON reference

Rate Benchmark API

Where do your hourly or project rates land against the market right now? This API ingests hundreds of thousands of public job postings and freelance contracts per week, normalizes the rates, and gives you four percentiles (P25/P50/P75/P90) per skill+region+experience-level combination — plus your personal market position and a recommended rate based on your saved profile. Free tier covers 1 comparison/month against your saved profile. Part of the Logic Igniter Professional Services bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/ratebenchmark.json

Operations rendered

Response models rendered

GET/api/v1/ratebenchmark/customers

List customers

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CustomersResponse

Page of customers

401Error

Missing or invalid API key.

POST/api/v1/ratebenchmark/customers

Provision a customer

Idempotent customer provision. Free tier limits the workspace to 1 personalized comparison per month.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: CreateCustomerRequest

Sample JSON payload for evaluation.

{
  "email": "[email protected]",
  "name": "Example Inc."
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/ratebenchmark/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"Example Inc."}'

Responses

201Customer

Customer created or returned

400Error

Invalid email or missing name

401Error

Missing or invalid API key.

GET/api/v1/ratebenchmark/customers/{id}

Get a customer by id

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200Customer

Customer record

401Error

Missing or invalid API key.

404Error

Customer not found

PUT/api/v1/ratebenchmark/customers/{id}

Update a customer

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request body (required)

Schema: UpdateCustomerRequest

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/ratebenchmark/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

200Customer

Updated customer

400Error

Invalid update

401Error

Missing or invalid API key.

404Error

Customer not found

GET/api/v1/ratebenchmark/profile

Get the workspace profile

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200Profile

Saved profile

401Error

Missing or invalid API key.

404Error

Profile not yet set

PUT/api/v1/ratebenchmark/profile

Set the workspace profile

Replace the workspace's skill/region/experience profile. The current rate (in cents) is used by `GET /position` and `GET /recommendation` to compute your percentile and personalized recommendation.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: SetProfileRequest

Sample JSON payload for evaluation.

{
  "skills": [
    "golang",
    "postgres",
    "kubernetes"
  ],
  "geo_region": "US-NYC",
  "experience_years": 8,
  "current_rate_cents": 18500
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/ratebenchmark/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"skills":["golang","postgres","kubernetes"],"geo_region":"US-NYC","experience_years":8,"current_rate_cents":18500}'

Responses

200Profile

Updated profile

400Error

Missing skills or invalid region

401Error

Missing or invalid API key.

GET/api/v1/ratebenchmark/benchmark

Rate percentiles for one skill+region+experience

Returns four percentiles (P25/P50/P75/P90) of hourly rates in cents and the sample size that backed the calculation.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type
`skill`required	query	string
`geo_region`required	query	string
`experience_level`	query	ExperienceLevel

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/benchmark" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200RateBenchmark

Rate benchmark

400Error

Missing skill or region

401Error

Missing or invalid API key.

404Error

No samples for that combination

GET/api/v1/ratebenchmark/benchmarks

List benchmarks for a skill

Return all per-region benchmarks for a single skill, paginated. Useful for building a heatmap or coverage UI.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type
`skill`required	query	string
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/benchmarks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200BenchmarksResponse

Page of benchmarks

401Error

Missing or invalid API key.

GET/api/v1/ratebenchmark/position

Where you sit in the market

Compares your saved profile's `current_rate_cents` against the matching benchmark and returns your percentile + the market median.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/position" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200MarketPosition

Market position

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 1 personalized comparison per month; paid plans unlock unlimited position+recommendation calls and historical trend windows.

404Error

Profile not set, or no benchmark matches profile

GET/api/v1/ratebenchmark/recommendation

Recommended rate for your profile

Returns a recommended hourly rate (cents), the percentile that maps to, and a short reasoning string explaining why (e.g. "P75 is the right anchor for senior engineers in this region").

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/recommendation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200RateRecommendation

Rate recommendation

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 1 personalized comparison per month; paid plans unlock unlimited position+recommendation calls and historical trend windows.

404Error

Profile not set, or no benchmark matches profile

GET/api/v1/ratebenchmark/trends

Rate trend over time

Time-series of average rate (in cents) per period for a skill in a region. Periods are ISO-week or month strings; default is the most recent 12 periods.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`skill`required	query	string
`geo_region`required	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/trends" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200RateTrend

Trend series

400Error

Missing skill or region

401Error

Missing or invalid API key.

GET/api/v1/ratebenchmark/demand-signals

Demand signals for a skill

Per-period posting count and percent change. Useful for spotting an inflection point in skill demand before adjusting your rate.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`skill`required	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/demand-signals" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200DemandSignals

Demand signals

400Error

Missing skill

401Error

Missing or invalid API key.

GET/api/v1/ratebenchmark/top-skills

Leaderboard of in-demand skills

Top N skills ranked by a combination of median rate and demand growth.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`limit`	query	integer

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/ratebenchmark/top-skills" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200TopSkills

Top skills

401Error

Missing or invalid API key.

Data models

Error

Field	Type	Notes
`error`required	string

ExperienceLevel

SetProfileRequest

Field	Type	Notes
`skills`required	array<string>	Example: ["golang","postgres"]
`geo_region`required	string	Example: "US-NYC"
`experience_years`	integer
`current_rate_cents`	integer (int64)	Example: 18500

Profile

Field	Type	Notes
`id`	string
`skills`	array<string>
`geo_region`	string
`experience_years`	integer
`current_rate_cents`	integer (int64)

RateBenchmark

Field	Type	Notes
`id`	string
`skill`	string
`geo_region`	string
`p25_cents`	integer (int64)
`p50_cents`	integer (int64)
`p75_cents`	integer (int64)
`p90_cents`	integer (int64)
`sample_size`	integer

BenchmarksResponse

Field	Type	Notes
`items`	array<RateBenchmark>
`next_page_token`	string
`total_count`	integer

MarketPosition

Field	Type	Notes
`id`	string
`percentile`	integer
`current_rate_cents`	integer (int64)
`market_median_cents`	integer (int64)

RateRecommendation

Field	Type	Notes
`id`	string
`recommended_rate_cents`	integer (int64)
`market_percentile`	integer
`reasoning`	string

TrendPoint

Field	Type	Notes
`period`	string
`avg_rate_cents`	integer (int64)
`posting_count`	integer

RateTrend

Field	Type	Notes
`id`	string
`points`	array<TrendPoint>

DemandPoint

Field	Type	Notes
`period`	string
`posting_count`	integer
`change_pct`	number (double)

DemandSignals

Field	Type	Notes
`id`	string
`points`	array<DemandPoint>

SkillRank

Field	Type	Notes
`skill`	string
`median_rate_cents`	integer (int64)
`demand_growth_pct`	number (double)
`rank`	integer

TopSkills

Field	Type	Notes
`items`	array<SkillRank>

CreateCustomerRequest

Field	Type	Notes
`email`required	string (email)
`name`required	string

UpdateCustomerRequest

Field	Type	Notes
`email`	string (email)
`name`	string

Customer

Field	Type	Notes
`id`	string (uuid)
`email`	string (email)
`name`	string
`created_at`	string (date-time)

CustomersResponse

Field	Type	Notes
`items`	array<Customer>
`next_page_token`	string
`total_count`	integer