curlNodePythonJavaRubyphpGo
Remote Weekly API
About this API

Every day, we collect jobs from the best job boards, social networks, career pages and recruitment sites. This adds almost 200 remote jobs / day to our database. Both tech & non-tech.

Now, you can access our data too. Useful links:

Readme

  1. Never make your API_KEY publicly available or visible. Use this API exclusively in your application’s back end.

  2. Every request listed below needs to contain the appropriate Authorization header.

  3. You can expect following status codes with appropriate JSON data.

Code Status
200: OK All good
403: Forbidden No Authorization header sent
401: Unauthorized Wrong or invalid API_KEY
402: Payment Required Out of quota / Membership expired
500: Server error This was our fault

Now, let’s get down to business.

Generic Collection
Hello World

This is a simple GET request intended to test your API access and also check you current quota usage. Validates API_KEY and returns basic subscriber information together with usage statistics.

Response object
Attribute Value
status string
bearer_owner string Name of the subscriber associated with provided API_KEY
plan string Type of subscription you are currently using
days_left integer How many days left in your subscription. Updated automatically with each payment.
monthly_quota integer Total number of API requests you can perform in 30 days
monthly_quota_usage integer Number of API requests you have made in the last 30 days
daily_quota integer Total number of API requests you can perform in 24 hours
daily_quota_usage integer Number of API requests you have made in the last 24 hours
Definition
GET https://v1.remoteweekly.ai/api/hello-world/
Request
Request Headers
Content-Type: application/json
Authorization: Bearer API_KEY
Example Request
curl --request GET \
--url https://v1.remoteweekly.ai/api/hello-world/ \
--header 'authorization: Bearer API_KEY' \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "status": "OK",
    "bearer_owner": "James Bond",
    "plan": "paid",
    "days_left": 14,
    "monthly_quota": 1000,
    "monthly_quota_usage": 128,
    "daily_quota": 100,
    "daily_quota_usage": 34
}
List of Positions

Returns a JSON object with the attribute positions containing all the accepted values for the /jobs/ endpoint described below.

Response object
Attribute Value
status string
positions object Categorized list of accepted values for the /jobs/ endpoint
Definition
GET https://v1.remoteweekly.ai/api/positions/
Request
Request Headers
Content-Type: application/json
Authorization: Bearer API_KEY
Example Request
curl --request GET \
--url https://v1.remoteweekly.ai/api/positions/ \
--header 'authorization: Bearer API_KEY' \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "status": "OK",
    "positions": {
        "engineering": [
            "frontend-coder",
            "backend-developer",
            "software-developer",
            "devops",
            "fullstack-developer",
            "system-architect",
            "big-data",
            "ios-developer",
            "android-developer",
            "data-scientist",
            "sql-engineer",
            "cloud-engineer",
            "security-expert",
            "qa-engineer",
            "infrastructure-engineer",
            "support-engineer",
            "deep-learning"
        ],
        "tech": [
            "quality-assurance",
            "wordpress-specialist",
            "ecommerce-consultant",
            "user-research",
            "site-administrator",
            "technical-support",
            "community-support",
            "docs-writer",
            "project-manager",
            "hr-recruiting"
        ],
        "design": [
            "ux-designer",
            "product-designer",
            "ux-ui-research",
            "graphic-designer",
            "3d-artist",
            "art-director",
            "product-owner",
            "web-designer",
            "creative-director"
        ],
        "sales_marketing": [
            "customer-support",
            "growth-smarketer",
            "content-creator",
            "performance-marketer",
            "content-marketer",
            "account-manager",
            "marketing-analyst",
            "ppc-specialist",
            "copywriter",
            "marketing-specialist",
            "social-media-jobs",
            "community-manager",
            "conversion-specialist",
            "advertising-pr-jobs",
            "customer-service",
            "online-advertising",
            "online-marketing-jobs",
            "social-media-marketer",
            "seo-sem-specialist",
            "sales-jobs",
            "sales-representative",
            "software-sales",
            "business-development",
            "account-management-jobs",
            "client-services",
            "writing",
            "blogging",
            "technical-writing",
            "email-marketing-manager"
        ],
        "non_tech": [
            "accountant",
            "legal-counsel",
            "business-consultant",
            "translator",
            "teaching",
            "virtual-assistant",
            "transcription-jobs",
            "consulting-jobs",
            "healthcare-consulting",
            "edu-consulting",
            "it-consulting",
            "proofreading",
            "accounting-finance-jobs",
            "bookkeeping",
            "auditing",
            "legal-jobs",
            "administrative-jobs",
            "appointment-setting",
            "call-center-jobs",
            "telemarketing",
            "business-development"
        ]
    }
}
Jobs Collection
Job List

Browse remote job positions with optional pagination and ordering. Sorted by created_at in descending order (newest first).

Parameters
Parameter Value
position string Comma-separated list of positions. Leave empty to list all jobs.
Response object
Attribute Value
status string
page integer
per_page integer
count integer How many jobs are in the items array
items array Array of job objects
Job object
uid string Unique identifier
title string Job title
company string Company name
created_at string ISO 8601 timestamp
detail_url string Link to /jobs/{uid}/ endpoint to fetch all job details
Url Parameters
  • position
    string
    Example: copywriter
  • page
    string
    Example: 1
Definition
GET https://v1.remoteweekly.ai/api/jobs/?position={position}&page={page}
Request
Request Headers
Content-Type: application/json
Authorization: Bearer API_KEY
Example Request
curl --request GET \
--url 'https://v1.remoteweekly.ai/api/jobs/?page=1&position=copywriter' \
--header 'authorization: Bearer API_KEY' \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "status": "OK",
    "page": 1,
    "items": [
        {
            "uid": "938a343a-879d8035-a6dd00d8-5c0d6e79",
            "title": "A.I. Sports Startup Seeks Golfers to Label Golf Swing Data [remote]",
            "lead": "Do you golf? Have an incredible attention to detail?  We are looking for someone to watch golf swings, label the swing quality + select specific tags to label issues with the swing.\nSparrow is a startup that’s redefining sports training th",
            "companyName": "Sparrow",
            "location": "Remote",
            "salary": null,
            "categories": [
                "engineering"
            ],
            "labels": [],
            "links": {
                "list": "http://remoteweekly.ai/search/engineering/",
                "detail": "http://remoteweekly.ai/portal/job/49262--a-i-sports-startup-seeks-golfers-to-label-golf-swing-data-remote/",
                "company": "http://remoteweekly.ai/portal/resources/company/49262--sparrow/"
            },
            "posted_at": "2020-09-18T00:01:19+00:00",
            "created_at": "2020-11-09T07:01:23+00:00",
            "is_active": false,
            "is_deleted": true,
            "seen": 323
        },
        {
            "uid": "938a343a-879d8035-a6dd00d8-5c0d6e79",
            "title": "A.I. Sports Startup Seeks Golfers to Label Golf Swing Data [remote]",
            "lead": "Do you golf? Have an incredible attention to detail?  We are looking for someone to watch golf swings, label the swing quality + select specific tags to label issues with the swing.\nSparrow is a startup that’s redefining sports training th",
            "companyName": "Sparrow",
            "location": "Remote",
            "salary": null,
            "categories": [
                "engineering"
            ],
            "labels": [],
            "links": {
                "list": "http://remoteweekly.ai/search/engineering/",
                "detail": "http://remoteweekly.ai/portal/job/49262--a-i-sports-startup-seeks-golfers-to-label-golf-swing-data-remote/",
                "company": "http://remoteweekly.ai/portal/resources/company/49262--sparrow/"
            },
            "posted_at": "2020-09-18T00:01:19+00:00",
            "created_at": "2020-11-09T07:01:23+00:00",
            "is_active": false,
            "is_deleted": true,
            "seen": 323
        },
        {},{},{},{}
    ]
}
Job Search

Perform fulltext search over our NoSQL database.

Maximum age of jobs is 60 days, older items are not indexed.

Sorted by created_at in descending order (newest first).

Response object
Attribute Value
“status” string
query string Your query string
page integer
per_page integer
count integer How many jobs are in the items array
items array Array of job objects
Job object
Attribute Value
uid string Unique identifier
title string Job title
company string Company name
created_at string ISO 8601 timestamp
detail_url string Link to /jobs/{uid}/ endpoint to fetch all job details
Url Parameters
  • page
    string
    Example: 1
Attributes
  • query
    stringRequired
    Your query string, MIN 3 characters
Definition
POST https://v1.remoteweekly.ai/api/jobs/search/?page={page}
Request
Request Headers
Content-Type: application/json
Request Body
{
  "query": ""
}
Example Request
curl --request POST \
--url 'https://v1.remoteweekly.ai/api/jobs/search/?page=1' \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "status": "OK",
    "page": 1,
    "query": "your-query",
    "items": [
        {
            "uid": "938a343a-879d8035-a6dd00d8-5c0d6e79",
            "title": "A.I. Sports Startup Seeks Golfers to Label Golf Swing Data [remote]",
            "lead": "Do you golf? Have an incredible attention to detail?  We are looking for someone to watch golf swings, label the swing quality + select specific tags to label issues with the swing.\nSparrow is a startup that’s redefining sports training th",
            "companyName": "Sparrow",
            "location": "Remote",
            "salary": null,
            "categories": [
                "engineering"
            ],
            "labels": [],
            "links": {
                "list": "http://remoteweekly.ai/search/engineering/",
                "detail": "http://remoteweekly.ai/portal/job/49262--a-i-sports-startup-seeks-golfers-to-label-golf-swing-data-remote/",
                "company": "http://remoteweekly.ai/portal/resources/company/49262--sparrow/"
            },
            "posted_at": "2020-09-18T00:01:19+00:00",
            "created_at": "2020-11-09T07:01:23+00:00",
            "is_active": false,
            "is_deleted": true,
            "seen": 323
        },
        {
            "uid": "938a343a-879d8035-a6dd00d8-5c0d6e79",
            "title": "A.I. Sports Startup Seeks Golfers to Label Golf Swing Data [remote]",
            "lead": "Do you golf? Have an incredible attention to detail?  We are looking for someone to watch golf swings, label the swing quality + select specific tags to label issues with the swing.\nSparrow is a startup that’s redefining sports training th",
            "companyName": "Sparrow",
            "location": "Remote",
            "salary": null,
            "categories": [
                "engineering"
            ],
            "labels": [],
            "links": {
                "list": "http://remoteweekly.ai/search/engineering/",
                "detail": "http://remoteweekly.ai/portal/job/49262--a-i-sports-startup-seeks-golfers-to-label-golf-swing-data-remote/",
                "company": "http://remoteweekly.ai/portal/resources/company/49262--sparrow/"
            },
            "posted_at": "2020-09-18T00:01:19+00:00",
            "created_at": "2020-11-09T07:01:23+00:00",
            "is_active": false,
            "is_deleted": true,
            "seen": 323
        },
        {},{},{},{}
    ]
}
Job Detail

Browse remote job positions with optional pagination and ordering.

Sorted by created_at in descending order (newest first).

Response object
Attribute Value
“status” string
page integer
per_page integer
count integer How many jobs are in the items array
item object job object
Job object
Attribute Value
uid string Unique identifier
title string Job title
company string Company name
created_at string ISO 8601 timestamp
detail_url string Link to /jobs/{uid}/ endpoint to fetch all job details
Definition
GET https://v1.remoteweekly.ai/api/jobs/{uid}/
Request
Request Headers
Content-Type: application/json
Authorization: Bearer API_KEY
Example Request
curl --request GET \
--url https://v1.remoteweekly.ai/api/jobs/{uid}/ \
--header 'authorization: Bearer API_KEY' \
--header 'content-type: application/json'
Response 200
Response Headers
Content-Type: application/json
Response Body
{
    "status": "OK",
    "item": {
        "uid": "5ff0181bf9a2af00b7a7b9ab489f05f8",
        "title": "Front end developer",
        "company": "Pied Piper",
        "company_url": "https://www.spacex.com",
        "company_logo": "https://remoteweekly.ai/assets/img/logo--ocean--w105.png?v=202011160433",
        "created_at": "2020-11-16T15:44:20+00:00",
        "location": "Remote USA",
        "salary": "$8,000 / year",
        "categories": ["Engineering"],
        "labels": ["foo", "bar", "baz"],
        "list_url": "https://www.google.com",
        "detail_url": "https://www.google.com",
        "target_url": "https://www.google.com",
        "is_active": true,
        "seen": 219,
        "is_deleted": false
    }
}