Links

Retrieve all

Endpoint

GET https://1in.me/api/links/

Example

curl --request GET \
--url 'https://1in.me/api/links/' \
--header 'Authorization: Bearer {api_key}' \

Parameters	Details	Description
page	Optional Integer	The page number that you want results from. Defaults to `1`.
results_per_page	Optional Integer	How many results you want per page. Allowed values are: `10` , `25` , `50` , `100` , `250` , `500` , `1000`. Defaults to `25`.

Response example

{ "data": [ { "id": 1, "project_id": null, "domain_id": 0, "type": "link", "url": "example", "location_url": "https://example.com/", "settings": { "password": null, "sensitive_content": false }, "clicks": 10, "order": 0, "start_date": null, "end_date": null, "datetime": "2025-11-21 11:01:43" } ], "meta": { "page": 1, "results_per_page": 25, "total": 1, "total_pages": 1 }, "links": { "first": "https://1in.me/api/links?&page=1", "last": "https://1in.me/api/links?&page=1", "next": null, "prev": null, "self": "https://1in.me/api/links?&page=1" } }

Retrieve one

Endpoint

GET https://1in.me/api/links/{link_id}

Example

curl --request GET \
--url 'https://1in.me/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

Response example

{ "data": { "id": 1, "project_id": null, "domain_id": 0, "type": "link", "url": "example", "location_url": "https://example.com/", "settings": { "password": null, "sensitive_content": false }, "clicks": 10, "order": 0, "start_date": null, "end_date": null, "datetime": "2025-11-21 11:01:43" } }

Create

Endpoint

POST https://1in.me/api/links

Parameters	Details	Description
type	Optional String	`link`
location_url	Required String	The URL of the destination.Available when: is_bulk = 0
location_urls	Required String	The URL of the destination.Available when: is_bulk = 1
url	Optional String	The URL alias of the generated link. Leave empty for a randomly generated one.Available when: is_bulk = 0
is_bulk	Optional Boolean
domain_id	Optional Integer	-
project_id	Optional Integer	-
pixels_ids	Optional Array Integer	-
schedule	Optional Boolean	-
start_date	Optional String	Available when: schedule = true
end_date	Optional String	Available when: schedule = true
clicks_limit	Optional Integer	-
expiration_url	Optional String	-
sensitive_content	Optional Boolean	-
http_status_code	Optional Integer	Allowed values: `301`, `302`, `307`, `308`
app_linking_is_enabled	Optional Boolean	-
cloaking_is_enabled	Optional Boolean	-
cloaking_title	Optional String	-
cloaking_meta_description	Optional String	-
cloaking_custom_js	Optional String	-
cloaking_favicon	Optional File	-
cloaking_opengraph	Optional File	-
password	Optional String	-
forward_query_parameters_is_enabled	Optional Boolean	-
utm_source	Optional String	-
utm_medium	Optional String	-
utm_campaign	Optional String	-
targeting_type	Optional String	`continent_code` , `country_code` , `device_type` , `browser_language` , `rotation` , `os_name` , `browser_name`
targeting_continent_code_key[index]	Optional String	Available when: targeting_type = continent_code
targeting_continent_code_value[index]	Optional String	Available when: targeting_type = continent_code
targeting_country_code_key[index]	Optional String	Available when: targeting_type = country_code
targeting_country_code_value[index]	Optional String	Available when: targeting_type = country_code
targeting_city_name_key[index]	Optional String	Available when: targeting_type = city_name
targeting_city_name_value[index]	Optional String	Available when: targeting_type = city_name
targeting_device_type_key[index]	Optional String	Available when: targeting_type = device_type
targeting_device_type_value[index]	Optional String	Available when: targeting_type = device_type
targeting_browser_language_key[index]	Optional String	Available when: targeting_type = browser_language
targeting_browser_language_value[index]	Optional String	Available when: targeting_type = browser_language
targeting_rotation_key[index]	Optional String	Available when: targeting_type = rotation
targeting_rotation_value[index]	Optional String	Available when: targeting_type = rotation
targeting_os_name_key[index]	Optional String	Available when: targeting_type = os_name
targeting_os_name_value[index]	Optional String	Available when: targeting_type = os_name
targeting_browser_name_key[index]	Optional String	Available when: targeting_type = browser_name
targeting_browser_name_value[index]	Optional String	Available when: targeting_type = browser_name

Example

curl --request POST \
--url 'https://1in.me/api/links' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'url=example' \
--form 'location_url=https://1in.me/' \

Response example

{ "data": { "id": 1 } }

Update

Endpoint

POST https://1in.me/api/links/{link_id}

Parameters	Details	Description
location_url	Optional String	The URL of the destination.
url	Optional String	The URL alias of the generated link. Leave empty for a randomly generated one.
domain_id	Optional Integer	-
project_id	Optional Integer	-
pixels_ids	Optional Array Integer	-
schedule	Optional Boolean	-
start_date	Optional String	Available when: schedule = true
end_date	Optional String	Available when: schedule = true
clicks_limit	Optional Integer	-
expiration_url	Optional String	-
sensitive_content	Optional Boolean	-
http_status_code	Optional Integer	Allowed values: `301`, `302`, `307`, `308`
app_linking_is_enabled	Optional Boolean	-
cloaking_is_enabled	Optional Boolean	-
cloaking_title	Optional String	-
cloaking_meta_description	Optional String	-
cloaking_custom_js	Optional String	-
cloaking_favicon	Optional File	-
cloaking_opengraph	Optional File	-
password	Optional String	-
forward_query_parameters_is_enabled	Optional Boolean	-
utm_source	Optional String	-
utm_medium	Optional String	-
utm_campaign	Optional String	-
targeting_type	Optional String	`continent_code` , `country_code` , `device_type` , `browser_language` , `rotation` , `os_name` , `browser_name`
targeting_continent_code_key[index]	Optional String	Available when: targeting_type = continent_code
targeting_continent_code_value[index]	Optional String	Available when: targeting_type = continent_code
targeting_country_code_key[index]	Optional String	Available when: targeting_type = country_code
targeting_country_code_value[index]	Optional String	Available when: targeting_type = country_code
targeting_city_name_key[index]	Optional String	Available when: targeting_type = city_name
targeting_city_name_value[index]	Optional String	Available when: targeting_type = city_name
targeting_device_type_key[index]	Optional String	Available when: targeting_type = device_type
targeting_device_type_value[index]	Optional String	Available when: targeting_type = device_type
targeting_browser_language_key[index]	Optional String	Available when: targeting_type = browser_language
targeting_browser_language_value[index]	Optional String	Available when: targeting_type = browser_language
targeting_rotation_key[index]	Optional String	Available when: targeting_type = rotation
targeting_rotation_value[index]	Optional String	Available when: targeting_type = rotation
targeting_os_name_key[index]	Optional String	Available when: targeting_type = os_name
targeting_os_name_value[index]	Optional String	Available when: targeting_type = os_name
targeting_browser_name_key[index]	Optional String	Available when: targeting_type = browser_name
targeting_browser_name_value[index]	Optional String	Available when: targeting_type = browser_name

Example

curl --request POST \
--url 'https://1in.me/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'is_enabled=0' \

Response example

{ "data": { "id": 1 } }

Delete

Endpoint

DELETE https://1in.me/api/links/{link_id}

Example

curl --request DELETE \
--url 'https://1in.me/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

Ready to unify your digital presence?

Join thousands of creators, brands, and businesses using 1INME to connect and grow their online presence.

Trusted by creators and businesses worldwide.

Verified Secure Reliable Scalable

Links

Retrieve all

Retrieve one

Create

Update

Delete

Ready to unify your digital presence?

Explore the Plans.